Django外键依赖迁移问题：Jenkins测试迁移失败（本地正常）

看起来你碰到了本地测试正常，但Jenkins CI环境跑python manage.py test -v 2 --noinput时迁移挂掉的问题——从你给出的日志看，前几个app的迁移都顺利执行，后面突然报错，这种情况大多是本地和CI环境的不一致导致的，我给你列几个最常见的排查方向：

🎯 先查数据库环境的差异 #

• 本地和Jenkins用的数据库版本是不是不一样？比如你本地用PostgreSQL 14，Jenkins跑的是12，有些SQL特性（比如JSONB的某些操作）在旧版本不支持，会导致迁移失败
• 测试数据库的权限够不够？Jenkins运行测试的用户有没有创建表、修改字段的权限？可以在Jenkins的构建步骤里加一条数据库授权命令（比如PostgreSQL的GRANT ALL PRIVILEGES ON DATABASE test_myproj TO jenkins_user;）试试
• 数据库的编码、排序规则是不是和本地不一样？比如本地是UTF8，Jenkins环境用了Latin1，迁移里如果有特殊字符的字段就会出问题

🎯 检查依赖版本是否完全一致 #

• 本地和Jenkins的Django、第三方库版本必须完全对齐！建议用requirements.txt或者pyproject.toml锁死所有依赖的版本号，别用>=这种模糊的写法。你可以在Jenkins里跑pip freeze，把输出和本地的pip freeze结果对比，看看有没有版本差异——比如payu_payment这个app的迁移可能依赖某个特定版本的SDK，Jenkins拉的版本不对就会报错
• 有没有本地装了某个依赖但没写到requirements里？比如本地用了某个数据库驱动的扩展，Jenkins环境没装

🎯 排查迁移文件本身的问题 #

• 你本地修改了迁移文件但没提交到代码仓库？比如gloodny.0020_auto_20180314_1338这个迁移，本地和仓库里的内容是不是一致？别漏提交了！
• 迁移里有没有写和环境绑定的逻辑？比如硬编码了本地的文件路径、只有本地有的环境变量，Jenkins环境没有这些，迁移执行到这里就会炸

🎯 检查Jenkins的执行环境 #

• Jenkins的工作目录有没有读写权限？Django跑测试时会生成临时文件，没权限的话会出问题
• 环境变量是不是全了？本地设置了DJANGO_SETTINGS_MODULE或者其他配置变量，Jenkins环境没设置的话，Django会用默认配置，可能和本地不一样。你可以在Jenkins构建步骤里先加一条printenv，把输出和本地的环境变量对比
• Python版本是不是一致？本地用3.9，Jenkins用3.7的话，某些语法（比如海象运算符）或者库的兼容性会有问题

🎯 清理测试数据库的残留数据 #

• Jenkins的测试数据库可能有旧的迁移记录或者残留数据，导致新的迁移执行冲突。你可以试试在执行测试前强制重建测试库：python manage.py test --noinput --keepdb=False，或者手动删除测试数据库再重新创建

如果能把完整的报错回溯贴出来（就是File "manage.py", line 22, in <module> exec...后面的内容），就能更精准定位问题了——比如是某个字段类型不支持，还是某个函数调用失败？

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