修改tailwind.config.js后Django生产环境collectstatic不生效

可能的原因与对应解决方案 #

1. 生产环境误用了开发模式的构建命令 #

本地的./manage.py tailwind start是开发专用命令，仅用于实时编译和热重载；生产环境必须执行生产构建命令，才能生成包含自定义断点规则的完整优化CSS：

• 在EC2服务器上执行：

  ./manage.py tailwind build
  

执行完成后再运行collectstatic，将最新编译的CSS上传到S3。

2. 静态文件未做版本控制，缓存未彻底清除 #

即使collectstatic上传了新文件，若文件名无哈希版本标识，S3、Cloudflare或浏览器仍会加载旧缓存：

• 在Django的settings.py中配置静态文件哈希版本：

  STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'
  

配置后Django会为静态文件添加哈希后缀（如app.abc123.css），更新后文件名变化，可彻底规避缓存问题。

• 登录S3控制台，检查目标CSS文件的内容和修改时间，确认是否为最新版本，旧文件可直接删除。

3. 生产环境的tailwind.config.js未同步 #

确认EC2服务器上的tailwind.config.js与本地修改后的版本一致，排查部署过程中是否遗漏了该文件的同步。可直接在EC2上查看文件内容，核对自定义断点规则是否存在。

4. collectstatic未彻底替换旧文件 #

执行collectstatic时添加--clear参数，强制清除旧文件后重新收集：

./manage.py collectstatic --clear

同时检查Django的STATIC_ROOT目录，确认tailwind子目录下的CSS文件是tailwind build生成的最新版本。

强制刷新静态文件的方法 #

• 手动删除S3桶中对应的Tailwind CSS文件，重新执行tailwind build和collectstatic。
• 在Cloudflare控制面板执行「Purge Everything」操作，彻底清除CDN缓存。
• 重启EC2上的应用服务（如Gunicorn、UWSGI），确保应用加载最新的静态文件引用。

内容的提问来源于stack exchange，提问作者Andi Fathul Mukminin