部署Django项目时出现开发环境字体路径找不到异常

• 清理Django及进程缓存

  • 执行python manage.py clearcache清除Django缓存（默认缓存后端有效）
  • 手动删除项目内所有__pycache__文件夹和.pyc字节码文件
  • 彻底重启ASGI服务（比如Uvicorn、Gunicorn），进程可能把旧的settings配置存在内存里没更新

• 验证STATICFILES_DIRS实际加载值

  • 在项目里加个临时视图打印配置：

    from django.http import HttpResponse
    from django.conf import settings
    
    def check_static_paths(request):
        return HttpResponse(f"STATICFILES_DIRS: {settings.STATICFILES_DIRS}")
    

  • 临时配置URL映射后访问这个页面，确认显示的是生产环境的静态目录，而非开发机的旧路径

• 检查静态文件收集状态

  • 确认已执行python manage.py collectstatic，静态文件都正确同步到STATIC_ROOT指定的目录
  • 检查拼接字体路径的代码，生产环境下建议用STATIC_URL或者收集后的静态根路径，而非直接用STATICFILES_DIRS（该配置更多用于开发阶段）

• 确认环境配置加载正确

  • 检查ASGI服务启动命令，是否指定了正确的生产环境settings文件（比如--settings=dimsumbox.settings.production）
  • 排查系统环境变量，有没有意外覆盖STATICFILES_DIRS的配置项

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