Django+React项目静态文件不更新，清浏览器缓存无效如何排查

核心结论前置 #

你的现象已经完全排除浏览器缓存、前端资源引用、公网链路问题（手机访问无效、新机器拷贝代码后功能正常是核心判断依据），开发模式下Django本身不会主动缓存静态文件，主开发机的问题100%出在本机的服务配置、进程状态或路径指向上。

主开发机故障的常见根因（按排查优先级排序） #

• 静态文件查找路径与实际构建产物错位
  这是最高发的场景：Django 会根据settings.py中STATICFILES_DIRS的配置去定位静态资源目录，很多开发者会在前期配置时填入绝对路径指向旧的项目副本目录，后续切换到新项目目录开发时没有同步修改配置，导致你在当前项目里修改前端组件、执行构建操作时，Django 实际读取的是其他位置的旧静态文件目录。这也是为什么你给URL加随机时间戳也没用——请求指向的根本不是你正在修改的目录里的新文件，加不加时间戳都是加载旧目录下的内容。
  排查操作：在项目目录下打开Django Shell，执行from django.conf import settings; print(settings.STATICFILES_DIRS)，逐行核对输出的路径是否指向你当前正在编辑的项目的前端构建产物目录，重点排查是否存在残留的旧项目路径、指向旧目录的软链接。
• 旧版本Django服务进程未关闭，请求打到了历史实例上
  Django 的自动重载机制对静态路径、核心配置类的修改不生效，很多时候主开发机会在后台残留几个月前启动的旧runserver进程，占用了你访问的端口。你误以为当前访问的是新启动的开发服务，实际请求一直被转发到旧进程上，而旧进程加载的还是之前的静态路径配置。
  排查操作：执行端口占用查询命令（Mac/Linux：lsof -i :<你的服务端口号>；Windows：netstat -ano | findstr :<你的服务端口号>），杀掉所有占用端口的相关进程后，重新启动runserver再测试。
• 前端构建输出位置与Django配置不匹配
  如果你在主开发机上修改了前端的构建配置（比如Vite/CRA的输出目录），但没有同步更新Django的静态路径配置，就会出现“代码改了、构建成功了，但Django读不到”的问题。全新安装环境的机器上因为配置文件是初始相对路径，不存在这类历史配置残留，所以可以正常加载更新内容。
  排查操作：在Django配置指向的静态资源目录下，手动新建一个带当前时间戳的测试文本文件，直接通过站点URL访问这个文件，如果拿到的不是你刚写入的内容，即可确认路径错位。
• 本地代理/缓存工具拦截请求
  主开发机上如果安装了Charles、Fiddler等抓包代理工具，或是杀毒软件、Node环境缓存组件对静态文件请求做了本地缓存，会返回之前存储的旧资源，这类缓存不区分访问终端（本机浏览器、手机浏览器走同一代理时都会命中缓存），和你遇到的现象完全匹配。

关于Django静态文件缓存的明确说明 #

开发模式（DEBUG=True）下，Django 内置的django.contrib.staticfiles服务没有任何主动的静态资源缓存逻辑，每次收到静态文件请求时，都会直接从配置的STATICFILES_DIRS目录读取最新文件内容返回，不会留存旧版本的文件副本。
只有当你将DEBUG=False、执行python manage.py collectstatic命令后，Django才会将静态文件集中拷贝到STATIC_ROOT目录，此时如果不重新执行collectstatic，才会出现长期调用旧静态文件的问题——这类情况在你的开发场景下不会触发。

结合你提供的网络加载截图中的响应头信息，也可以通过Last-Modified字段的时间戳快速判断：如果返回的文件修改时间远早于你当前修改组件的时间，即可直接锁定路径错配或旧进程的问题。

内容的提问来源于stack exchange，提问作者Kuba Strączek