运行Django Python服务时登录触发“Exception has occurred”异常如何解决？

常见触发原因 #

• 登录视图自定义逻辑存在未捕获异常：比如自定义用户模型字段校验失败、密码加密方法传参错误、关联外键查询不存在数据触发DoesNotExist异常
• 登录表单逻辑错误：自定义表单clean()校验方法存在空值调用属性/方法的问题，触发AttributeError
• 数据库相关异常：提交登录请求时数据库服务断开、用户认证相关表未执行迁移导致字段不存在，触发OperationalError/ProgrammingError
• 中间件逻辑错误：自定义认证中间件处理登录请求时，未对未登录状态的请求做空值判断，直接调用request.user相关属性触发异常
• 版本兼容性问题：Django版本和第三方登录认证插件（如django-allauth）版本不匹配，调用已废弃接口触发ImportError/AttributeError

排查步骤 #

• 开启调试模式定位问题：在项目settings.py中将DEBUG参数设为True，重启服务后重新提交登录请求，页面会直接展示完整异常栈，可直接定位异常触发的代码行
• 查看运行日志：生产环境无法开启调试模式时，查看服务终端输出或配置的日志文件，提取异常类型和回溯路径，确认异常归属类型
• 最小范围复现验证：注释掉登录视图、登录表单、认证中间件的自定义代码，使用Django原生auth登录组件提交请求，若原生逻辑正常则逐一恢复自定义代码定位问题点
• 校验依赖版本：执行pip list查看已安装依赖版本，对照Django官方文档和第三方认证插件的版本文档，确认版本兼容关系

修复方案 #

• 未捕获业务异常修复：在登录视图中增加try-except捕获块，对DoesNotExist、AttributeError等常见异常做兼容处理，返回友好错误提示而非直接抛出异常导致服务崩溃
• 数据库问题修复：执行python manage.py makemigrations和python manage.py migrate完成表结构迁移，验证数据库服务运行状态和settings.py中数据库连接参数的正确性
• 版本兼容问题修复：卸载不兼容的依赖包，安装匹配版本，例如Django 4.x版本需要搭配django-allauth 0.50及以上版本
• 代码逻辑问题修复：根据异常栈定位到具体代码行后，补充空值判断、修正参数传递错误，测试通过后再上线运行

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