Django中python manage.py runserver失效，如何排查修复？

• 盯紧终端报错信息
  启动python manage.py runserver时别着急关终端，仔细看输出的错误内容——语法错误、导入失败、URL配置错误是最常见的原因。比如出现ImportError大概率是Products应用的模块没导入对；URLConfError可能是urls里的path写法有误。

• 确认Products应用已注册
  检查项目根目录的settings.py，确保INSTALLED_APPS列表里添加了'products'，没注册的话Django识别不到这个应用，直接导致URL映射失效。

• 核对所有URL配置细节

  • 父级urls.py：先确认已经导入include，比如from django.urls import path, include，再检查path('products/', include('products.urls'))的符号、拼写有没有错，比如引号漏写、逗号位置不对。
  • Products应用的urls.py：必须定义urlpatterns列表，每个path对应的视图函数要正确导入（比如from .views import product_list），视图函数的名字不能写错。

• 检查视图函数代码
  打开products/views.py，排查有没有语法错误：比如缩进不对、变量名拼写错误、缺少冒号，或者引用了不存在的模块/模板。比如视图里写了render(request, 'product.html')但模板文件不存在，也会导致服务崩溃。

• 清理缓存后重启服务
  按Ctrl+C彻底停掉runserver，删除项目根目录和products应用里的__pycache__文件夹，再重新执行python manage.py runserver，有时候缓存残留会导致奇怪的问题。

• 换端口启动排查占用问题
  如果8000端口被其他程序占用，启动时指定其他端口试试：python manage.py runserver 8001，能正常运行的话就是端口占用的问题。

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