Django CountrySelectWidget在Debug=False时国旗图标损坏问题求助

核心原因 #

CountrySelectWidget组件渲染国旗时会调用django_countries内置的静态国旗资源，你此前判断该组件不涉及静态文件调用的结论有误：组件生成的国旗img标签src属性会指向django_countries包内置的countries/flags/[国家代码].png静态资源。
Debug=True时Django会自动处理所有已安装APP下的静态文件请求，因此资源可正常加载；Debug=False时Django不再主动处理APP静态文件，即使你已做过静态文件配置，也大概率是以下配置遗漏导致资源加载失败。

排查解决步骤 #

• 确认INSTALLED_APPS配置中已加入django_countries
  只有将django_countries加入已安装应用列表，执行python manage.py collectstatic命令时才会自动将该包内置的国旗静态文件收集到你的STATIC_ROOT目录下，这是绝大多数同类问题的根因。
• 校验静态文件收集结果
  重新执行collectstatic命令后，打开你的STATIC_ROOT对应目录，确认存在countries/flags子目录，且目录下存在对应国家的png格式国旗文件。
• 检查STATIC_URL配置
  Django 3.1版本要求STATIC_URL必须以斜杠开头，正确配置示例：

  STATIC_URL = '/static/'
  STATIC_ROOT = BASE_DIR / 'staticfiles' # 替换为你实际的静态文件收集目录
  

• 确认生产环境静态文件服务配置
  Debug=False时Django本身不会处理静态文件请求，需要用Nginx/Apache等Web服务器配置路由，将/static/开头的请求指向你的STATIC_ROOT目录。
  示例Nginx配置片段：

  location /static/ {
      alias /path/to/your/staticfiles/; # 替换为你实际的STATIC_ROOT绝对路径
  }
  

临时测试方案 #

如需快速验证是否为静态文件路由问题，可在项目根urls.py中临时添加静态文件路由规则（仅用于测试，禁止在生产环境使用）：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的原有路由规则
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

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