生产环境Express仅静态JS文件返回404，本地开发环境正常

我帮你梳理下这个问题的可能原因和解决办法，这种本地正常、生产出问题的情况，通常是环境差异或者部署细节没做到位导致的：

最可能的几个原因及排查步骤 #

1. 文件名大小写不匹配 #

Mac的文件系统默认是大小写不敏感的，但绝大多数生产服务器用的Linux系统是大小写敏感的。比如你本地请求/assets/jquery/dist/jquery.min.js，但服务器上实际文件是jQuery/dist/jquery.min.js，本地能正常访问，生产环境就会直接返回404。

排查方法：

• 登录生产服务器，进入app/public/assets目录，执行ls -la查看实际文件名的大小写，和你请求的URL路径完全对比。

2. 生产服务器上JS文件根本不存在 #

有可能部署的时候，assets目录下的JS文件没被同步到生产服务器，比如被.gitignore排除了，或者部署脚本漏了复制这些文件。

排查方法：

• 直接在生产服务器上检查文件是否存在：执行ls -la /path/to/your/app/public/assets/jquery/dist/（替换成你实际的项目路径），确认jquery.min.js是否存在。
• 查看项目根目录的.gitignore文件，看看有没有写assets/之类的规则，导致JS文件没被提交到Git，部署时自然没有。

3. Express静态资源目录路径配置错误 #

虽然你本地的path.join(__dirname, "public")是正确的，但生产环境下__dirname的实际路径可能和本地不一样（比如部署时app.js的位置变了），导致静态资源指向的目录不对。

排查方法：

• 在app.js里加一行日志输出，确认静态资源目录的绝对路径：

  const publicPath = path.join(__dirname, "public");
  console.log("静态资源服务目录:", publicPath);
  app.use(express.static(publicPath));
  

• 重启生产服务器的服务，查看日志里的路径是否正确，并且该路径下确实存在assets文件夹。

4. 中间件的影响（可能性较低，但可以排查） #

你用到的sass-middleware和helmet都有可能间接影响静态资源的访问：

• sass-middleware的src和dest都指向public目录，会不会在生产环境编译Sass时意外覆盖或删除了assets里的文件？
• helmet的Content-Security-Policy虽然一般不会导致404，但可以临时注释掉测试，排除规则冲突的可能。

排查方法：

• 先注释掉sass-middleware和helmet的代码，重启服务后再请求JS文件，如果能返回200，再逐个恢复中间件，定位是哪个的问题。

总结 #

优先从文件存在性和大小写匹配这两个最基础的点排查，这是本地与生产环境差异最常见的坑。如果这两个没问题，再去确认静态资源路径和中间件的影响。

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