Python多模块项目落地DevOps CI/CD时setup.py及测试任务报错求解

setup.py 执行报“无法找到对应包” #

• 修正CI执行的工作目录：执行构建命令前，先通过cd 目标模块名切换到模块根路径，再执行python setup.py build/install，不要在仓库根目录直接跨路径调用模块下的setup.py，避免setup.py内的相对路径解析错位
• 校准setup.py内的包发现逻辑：setuptools.find_packages()默认从命令执行目录扫描包，多模块场景下要传入明确的扫描范围，比如find_packages(where=".", include=["你的模块名*"])，避免扫描到仓库根目录下的无效目录结构
• 对齐包路径映射规则：原来单项目下package_dir的路径配置，要匹配模块内部的目录结构重新调整，比如模块源码存放在src子目录时，要明确映射包名对应的实际目录路径，不要沿用原来根目录下的相对路径

测试执行报“无法定位测试资源/测试包” #

• 配置Python解释器搜索路径：执行测试命令前，通过export PYTHONPATH=$PYTHONPATH:./目标模块名/src把模块的源码目录加入环境变量，解决pytest等测试工具找不到模块代码、关联资源的问题
• 调整测试路径配置：在模块根目录的pytest配置文件中明确指定testpaths = tests，绑定模块自身的测试目录路径，不要依赖仓库根目录的全局测试配置
• 补齐资源文件打包规则：如果测试涉及读取模块内的静态资源，要在setup.py的package_data中配置对应资源文件的匹配规则，避免路径错位

• 精细化配置流水线触发规则：通过CI的路径过滤能力，仅当对应模块目录下的文件发生变更时，才触发该模块的构建、测试、部署流程，避免每次任意模块变更都触发全仓流水线，减少无效计算资源消耗
• 抽离通用流水线逻辑：把Python环境初始化、pip依赖安装这类通用步骤做成可复用的流水线片段，每个模块仅需传入自身的模块名、专属构建命令即可接入，避免重复维护多份重复的流水线配置
• 分层管理项目依赖：各模块的专属依赖独立维护在自身目录的requirements.txt中，跨模块共享的公共依赖统一沉淀到仓库根目录的公共依赖配置中，通过缓存机制加速依赖安装过程
• 流水线路径隔离：为每个模块单独设置pip缓存目录、构建产物输出目录，避免不同模块的依赖版本、构建产物互相干扰
• 制品存储隔离：各模块构建产出的Python包、容器镜像，在制品仓库中按模块名做目录隔离，部署环节仅拉取对应模块的专属制品，避免版本混淆

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