Catalyst AppSail部署后遇pydantic_core模块找不到错误，该如何解决？

安全阿岳

2026-6-13

解决Catalyst AppSail部署后pydantic-core模块找不到的问题

确认依赖清单正确性
本地安装pydantic-core后，务必在Catalyst AppSail目录下执行pip freeze > requirements.txt，将当前环境的依赖准确写入清单文件。检查文件内是否存在pydantic-core==[你的本地版本号]，避免出现pydantic core这类带空格的错误包名——这是导致模块名识别错误的常见原因。
确保部署包包含依赖清单
Catalyst AppSail部署时会自动读取requirements.txt安装依赖，因此必须保证该文件被包含在部署包内。如果手动打包部署，确认zip包中包含此文件；如果使用catalyst deploy命令，确保目录结构中requirements.txt未被忽略。
对齐本地与远程Python版本
pydantic-core对Python版本有兼容性要求，若本地开发版本与Catalyst远程环境版本不一致，可能导致依赖安装失败或模块无法加载。执行python --version查看本地版本，再到Catalyst控制台确认AppSail的Python运行环境版本，保持两者一致。
手动指定依赖安装（自动安装失效时）
若自动读取requirements.txt安装依赖失败，可在启动脚本中添加手动安装命令。例如在启动脚本内加入：
```
pip install pydantic-core==[你的本地版本号]
```
确保部署时优先执行该命令完成依赖安装。
清理缓存重新部署
远程环境的缓存可能导致依赖未更新，执行catalyst deploy --clean（若支持该参数）清理本地部署缓存后重新部署，或手动删除本地临时部署文件后再执行部署操作。