如何排查Django的‘Internal Server Error’？新手实用指南

原因 #

• DEBUG模式未开启：Django默认在DEBUG=True时展示带堆栈信息的详细错误页面，当DEBUG=False时，出于安全和性能考虑，仅返回通用的"Internal Server Error"提示。开发环境若误关DEBUG，也会出现此情况。
• 自定义500错误页面覆盖：如果项目中配置了handler500自定义视图或templates/500.html模板，服务器出错时会直接返回该自定义页面，替代默认的详细错误信息。
• 错误发生在初始化阶段：若错误出现在Django加载配置、初始化中间件的启动阶段，此时详细错误页面尚未生成，会直接返回通用500错误。
• 静态文件配置异常：开发环境中静态文件（CSS/JS等）配置错误时，可能触发未被捕获的异常，部分场景下DEBUG模式也无法展示详细错误，转而返回通用提示。

排查方法 #

• 检查DEBUG与ALLOWED_HOSTS配置：打开项目settings.py，确认开发环境下DEBUG=True，同时ALLOWED_HOSTS包含当前访问的主机（如['localhost', '127.0.0.1']）。DEBUG开启时，ALLOWED_HOSTS的限制会放宽，但配置不当也可能导致错误页面异常。
• 查看Django日志：无论DEBUG状态如何，Django都会将错误信息记录到日志中。默认情况下，开发服务器的终端会输出ERROR级别日志；若配置了文件日志，可查看指定的日志文件，里面包含完整的错误堆栈和上下文信息。
• 临时开启DEBUG排查生产环境问题（注意安全）：若生产环境出现该问题，可临时将DEBUG=True并调整ALLOWED_HOSTS（测试完成后立即改回，避免安全风险），访问出错页面获取详细错误信息。
• 禁用自定义500错误处理：暂时注释settings.py中的handler500配置，或删除templates/500.html模板，重新测试是否能显示详细错误。
• 逐段定位出错代码：针对特定请求路径，逐步注释对应的视图、模板代码，定位具体出错模块；也可在关键位置添加print()语句或使用logging模块输出变量值，追踪代码执行状态。
• 排查中间件问题：若错误在服务器启动时出现，可逐个注释settings.py中MIDDLEWARE列表的项，重启服务器后测试，确认是否由某个中间件引发错误。

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