buildozer android debug命令失败 提示缺少toml模块解决方案

ModuleNotFoundError: No module named 'toml'报错的核心原因是Python包安装路径与buildozer运行时的Python搜索路径不匹配：

• 执行sudo python3 -m pip install toml时，toml被安装到root用户私有包目录/root/.local/lib/python3.8/site-packages，普通用户运行WSL终端时使用当前登录用户权限，Python不会扫描root用户的私有包路径，无法识别到已安装的toml。
• WSL环境下混用sudo pip与普通用户pip极易出现这类路径错位问题，buildozer、python-for-android工具链默认调用全局路径下的/usr/bin/python3，不会主动读取root用户目录下的安装包。

按顺序执行以下操作即可解决问题：

1. 清理错误安装到root私有目录的toml包，避免后续路径冲突

sudo python3 -m pip uninstall -y toml

2. 安装系统全局适配的toml依赖，优先使用apt源安装保证路径匹配

sudo apt update && sudo apt install -y python3-toml

如果执行时提示找不到python3-toml包，可替换执行sudo python3 -m pip install --system toml，--system参数会强制将包装到Python全局site-packages路径，不会落到用户私有目录。

3. 验证依赖识别状态，执行以下命令如果正常输出版本号即代表路径配置正确

/usr/bin/python3 -c "import toml; print(toml.__version__)"

4. 彻底清理历史错误构建缓存，注意不要加sudo执行buildozer，避免权限混乱

buildozer android clean

5. 重新执行打包命令即可正常运行构建流程

buildozer android debug

• 所有buildozer相关操作禁止加sudo执行，否则会将构建目录权限改为root，后续普通用户运行会触发各类读写权限报错
• 后续遇到python-for-android相关模块缺失报错，优先通过apt install python3-<模块名>安装系统源适配包，相比sudo pip安装的包路径兼容性更好
• 需确保WSL运行的Ubuntu版本为20.04及以上，18.04及更早版本搭载的Python3.6对新版buildozer兼容性极差，易触发各类依赖问题

内容的提问来源于stack exchange，提问作者MindW1n