Brython项目中自定义模块路径的根目录解析问题分析

问题背景

Brython是一个将Python代码编译成JavaScript并在浏览器中运行的项目。在最新版本中，Brython提供了__BRYTHON__.runPythonSource()方法，允许开发者通过pythonpath参数指定自定义的模块搜索路径。然而，开发者发现当页面从网站根目录(如/)加载时，模块导入会出现路径解析错误。

问题现象

当使用以下代码在根路径页面中导入模块时：

const code = `
import brython_runner
print('hello world')`

window.__BRYTHON__.runPythonSource(code, { pythonpath: ["/bry-libs/"]})

会出现以下错误：

File "http://localhost:3000/brython_runner.py", line 10
    </head>
IndentationError: unindent does not match any outer indentation level

有趣的是，当页面从非根路径(如/demo)加载时，相同的代码却能正确解析模块路径为http://localhost:3000/bry-libs/brython_runner.py并正常工作。

技术分析

这个问题源于Brython在根路径下处理模块搜索路径时的逻辑缺陷。具体表现为：

1. 当页面URL为根路径时，Brython未能正确拼接自定义路径和模块名
2. 导致系统直接尝试从根路径加载模块文件，而非指定的/bry-libs/目录
3. 由于根路径下不存在该Python文件，服务器可能返回HTML页面(如404页面)
4. Brython尝试将HTML内容作为Python代码解析，从而产生缩进错误

解决方案

Brython核心开发者已修复此问题，主要修改了路径拼接逻辑，确保：

1. 无论页面URL是否为根路径，都能正确应用pythonpath参数
2. 模块搜索路径的拼接始终保持一致
3. 避免将非Python文件内容误认为Python代码

最佳实践

开发者在使用Brython的模块导入功能时，应注意：

1. 明确指定所有自定义模块搜索路径
2. 确保路径格式正确，以斜杠开头和结尾(如/bry-libs/)
3. 在生产环境中测试不同URL路径下的模块导入行为
4. 使用浏览器开发者工具检查实际的模块请求URL

总结

这次Bug修复确保了Brython在不同URL路径下模块导入行为的一致性，增强了框架的可靠性。开发者现在可以放心地在各种部署场景下使用自定义模块路径功能。