Express静态文件本地正常但Railway返回404的排查与优化问询

问题背景 #

本地开发时Express.js应用能正常加载所有静态文件，但部署到Railway后，仅HTML页面可正常访问，CSS、JS及图片资源全部返回404错误。

环境信息 #

• Node.js 22、Express、EJS模板、ES模块（配置"type": "module"）
• 静态文件存放路径：/public文件夹（CSS在public根目录，图片在/public/images，JS在/public/js）
• 部署平台：Railway

相关代码片段 #

Express静态资源中间件配置 #

app.use(express.static(path.join(__dirname, 'public')));

EJS模板中静态资源引用 #

<link rel="stylesheet" href="/main.css">
<script src="/js/home.js"></script>

Railway错误日志 #

❌ 404 - Not Found: /images/fireplace3.jpg
❌ 404 - Not Found: /js/home.js

已尝试的排查操作 #

• 使用path.join(__dirname, 'public')设置绝对路径 ✅
• 在setHeaders中添加明确MIME类型头 ✅
• 检查Helmet内容安全策略（CSP）配置 ✅
• 修复.gitignore配置 ✅

根本原因 #

项目继承的Gatsby模板.gitignore文件中包含public条目，导致整个public文件夹被Git忽略，未被提交到版本库，最终未部署到Railway容器中。

问题解答 #

如何更早发现此类问题？ #

• 本地Git状态检查：执行git status查看public文件夹是否处于未追踪状态；用git ls-files命令确认该文件夹下的文件是否已被纳入版本控制，避免忽略必要资源
• 本地容器模拟：用Docker构建本地镜像并运行，模拟Railway的容器环境，提前验证静态资源是否能正常加载
• 构建流程校验：在CI/CD流程（如GitHub Actions或Railway构建步骤）中添加校验逻辑，检查构建产物中是否包含public目录，若缺失则终止构建并触发告警

Railway平台推荐的静态资源服务模式 #

• 静态资源独立托管：若静态资源占比高，可将public目录单独通过Railway的静态站点服务托管，与Express后端服务分离，降低后端负载
• 构建阶段同步资源：在package.json的build脚本中添加复制命令（如cp -r public dist/），确保构建产物中包含静态资源，避免部署时遗漏
• 使用Railway资产存储：将图片、大体积静态文件上传至Railway资产存储服务，借助CDN加速访问，同时减少代码包体积，避免资源与代码绑定部署

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