Node应用部署至Heroku报Internal Server Error，本地运行正常如何解决

Procfile配置修正 #

你当前Procfile中写入的内容存在两处容易导致异常的配置问题：

• 不要在Procfile的启动命令外层包裹多余双引号，这类格式问题可能导致Heroku解析进程命令时出现非预期的行为
• 生产环境不要使用npm run dev作为启动命令：dev脚本一般是面向本地开发场景设计的，通常会绑定固定本地端口、携带热更新监听逻辑，不符合Heroku web进程需要绑定动态分配端口的运行要求。正确的配置应当指向生产启动命令，写法如下：
  web: npm start
  对应package.json中的start脚本需要确保端口监听逻辑适配Heroku环境，即读取系统分配的process.env.PORT值作为监听端口，不要写死本地3000端口。

sendFile触发500的核心原因排查 #

既然将接口返回替换为res.send('hello')时应用可以正常运行，说明进程启动、端口绑定、中间件加载的基础链路是通的，问题完全出在文件发送的执行环节，按以下优先级排查：

• 检查路径大小写匹配：本地Windows/macOS的文件系统默认大小写不敏感，即使路径和实际文件名大小写不一致也能正常读取；但Heroku运行在Linux环境下，文件系统严格大小写敏感，比如实际存储的目录名为Public、文件名为Index.html，哪怕只是一个字符的大小写差异，都会导致res.sendFile抛出文件不存在的错误，触发默认500响应
• 替换手动拼接的路径写法，使用已经引入的path模块完成跨环境兼容的路径拼接，避免斜杠方向、路径层级的解析错误。当前代码中的res.sendFile(__dirname + "/public/index.html")可替换为稳健写法：

res.sendFile(path.join(__dirname, 'public', 'index.html'))

注意你之前注释掉的代码存在隐蔽语法bug：path.join(__dirname, + "public", 'index.html')中+ "public"的写法会将字符串强转为NaN，最终拼接出无效路径，该写法即使取消注释也会直接报错。

• 核对Git仓库的忽略配置：检查.gitignore文件是否误将public目录加入了忽略列表，如果public目录没有被提交到远程仓库，Heroku的运行环境中根本不存在这个目录下的文件，自然会触发文件读取失败的500错误。

优化建议 #

• 你已经配置了express.static静态资源中间件指向public目录，当该目录下存在index.html文件时，中间件会自动匹配根路径请求返回该文件，完全可以去掉单独编写的根路由sendFile逻辑，减少路径解析的出错概率
• 给sendFile调用补充简单的错误回调，方便快速定位具体问题：

app.get("/", (req, res, next) => {
  res.sendFile(path.join(__dirname, 'public', 'index.html'), (err) => {
    if (err) next(err);
  })
})

部署后通过Heroku的运行日志可以直接看到具体的报错堆栈，快速定位是路径问题、权限问题还是文件缺失问题。

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