部署Django 3.2.12应用后出现Key Error，本地正常线上异常求助

核心排查方向 #

• Choices配置与数据库数据不匹配：检查模型中对应字段的choices定义，是否缺少值为1的选项。比如模型字段定义了STATUS_CHOICES = ((0, '正常'), (2, '禁用'))，但线上数据库存在status=1的记录，Django Admin渲染时找不到对应映射就会触发KeyError。
• 本地与线上数据不同步：确认线上数据库的数据是否和本地一致，是否存在本地没有的异常值（比如1）。可以通过MySQL命令行查询对应字段值：

  SELECT 问题字段名 FROM 表名 WHERE id = 报错记录ID;
  

• 环境配置差异：核对本地与线上settings.py的数据库配置（如MySQL引擎、字符集）、时区设置（USE_TZ），避免因类型转换导致值读取异常。比如线上数据库字段类型被误改为字符串类型，读取到的'1'与代码中整数1不匹配。
• 缓存与代码版本问题：清理线上应用缓存，执行命令：

  python manage.py clearcache
  

  同时确认线上部署的代码是最新版本，没有遗漏本地已更新的choices配置。
• 自定义Admin逻辑问题：如果自定义了Admin类或使用第三方Admin插件，检查自定义的字段渲染方法（如formfield_for_choice_field）是否处理了值1的情况，避免逻辑遗漏。

快速验证方案 #

1. 临时在模型的choices中添加(1, '临时占位')，重新部署后观察是否仍报错，以此确认是否为choices缺失导致。
2. 修改线上数据库中对应记录的字段值为代码已有的选项值，验证Admin功能是否恢复正常。

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