修复相对路径问题：ENOENT文件不存在？开发正常生产环境读取失败排查

这种情况我在部署Node.js项目时踩过好几次坑，给你梳理下核心原因和解决办法：

一、导致错误的常见原因 #

• 工作目录（CWD）不匹配：这是最常见的根源。开发时你大概率在项目根目录启动服务（比如node src/app.js），此时../views/...这种相对路径会基于根目录正确解析；但生产环境中，你可能在子目录（比如dist/）启动服务，或者用PM2、容器部署时默认工作目录不是项目根，导致相对路径指向了错误的位置。
• 文件名大小写问题：如果开发环境是Windows或默认不区分大小写的macOS，article.hbs和Article.hbs会被当成同一个文件；但生产环境多为Linux/Unix系统，严格区分大小写，一旦slug对应的文件名大小写不对，就会触发找不到文件的错误。
• 部署时遗漏文件：比如用Webpack、Vite这类构建工具打包时，没把.hbs模板文件复制到生产目录，或者部署脚本漏掉了views文件夹，导致生产环境根本没有目标文件。
• 文件权限不足：生产环境的Node进程可能没有读取目标文件的权限，哪怕文件确实存在，也会因为权限问题返回ENOENT错误（部分系统会把权限不足伪装成文件不存在）。

二、查看脚本实际尝试读取的路径 #

最直接的方式是把相对路径转成绝对路径并打印出来，这样就能精准定位问题：

const path = require('path'); // 别忘了引入Node的path模块
// 替换成你实际的slug变量
const filePath = path.resolve('../views/articles/' + slug + '.hbs');
console.log('Node实际尝试读取的路径:', filePath);
// 同时可以打印当前工作目录，对比预期的根目录
console.log('当前工作目录:', process.cwd());

运行这段代码后，你就能清楚看到Node到底在找哪个路径，和你预期的文件位置一对比，就能知道是不是路径解析错了。

三、确认文件存在的关键检查点 #

• 根据上面打印的绝对路径，直接在生产服务器上用命令行验证：比如Linux下用ls /打印的绝对路径或者stat /打印的绝对路径，看文件是否真的存在。
• 仔细核对文件名的大小写，尤其是生产环境是Linux系统时，大小写必须完全匹配。
• 检查文件权限：确保Node进程的运行用户（比如www-data或你部署用的账号）对该文件和上级目录有读取权限，必要时用chmod +r 文件路径或chown 用户:组 文件路径调整。
• 确认部署流程：检查构建或部署脚本是否把views目录及其下的所有文件都同步到了生产环境，有没有被构建工具的配置过滤掉。

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