PyScript项目中MicroPython处理压缩包资源的问题解析

在PyScript项目的最新版本2024.4.1中，开发者发现了一个关于MicroPython运行时处理压缩包资源(zip/tgz格式)的兼容性问题。这个问题表现为当尝试在浏览器本地文件系统中解压资源包时，会抛出不透明的错误信息。

问题现象

当开发者尝试通过settings.json配置使用tgz压缩包资源时，MicroPython运行时会抛出OSError: 44的错误。这个问题在Firefox和Chrome浏览器上都能复现，错误信息显示在解压过程中出现了问题。

技术分析

经过深入调查，发现这个问题与MicroPython的文件系统操作特性有关。与Pyodide运行时不同，MicroPython在处理压缩包资源时存在以下限制：

1. 目录创建机制差异：MicroPython的os.mkdir方法不支持类似Unix系统中"mkdir -p"的递归创建目录功能。这意味着如果压缩包中包含多级目录结构，解压过程可能会失败。

2. 异步执行上下文：开发者代码中在主执行上下文中使用了await关键字，这在MicroPython中会导致语法错误，正确的做法是将异步操作封装在async函数中或使用script标签的async属性。

解决方案

针对这个问题，PyScript项目组已经采取了以下措施：

1. 底层修复：在polyscript库中增加了对MicroPython解压逻辑的特殊处理，确保能够正确解压包含多级目录的压缩包。

2. 使用规范：开发者需要注意在MicroPython环境下：

   • 避免在主执行上下文中直接使用await
   • 确保压缩包中的目录结构是平坦的，或者自行处理多级目录的创建

验证结果

修复后的版本已经通过测试，并提供了工作示例。新的实现能够正确处理包含单文件和多级目录结构的压缩包资源，解决了原先的兼容性问题。

最佳实践建议

对于需要在PyScript中使用压缩包资源的开发者，建议：

1. 优先使用zip格式而非tgz格式
2. 简化压缩包中的目录结构
3. 将异步操作封装在适当的async函数中
4. 在script标签中添加async属性以支持顶层await

这个问题展示了不同Python运行时在浏览器环境中的行为差异，开发者在跨运行时开发时需要注意这些实现细节。