部署在Linode Ubuntu上的Node/Express应用：Nginx无法加载EJS视图模板

我将Node.js + Express网站部署在Linode的Ubuntu LTS 22.04服务器上，使用Nginx作为反向代理服务。本地运行完全正常，生产环境下API接口也能正常工作，但所有EJS视图模板均无法加载。已尝试修改app.set("views", ...)中的路径（如添加斜杠），并查阅相关博客，但问题仍未解决。

Nginx默认配置文件 #

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://127.0.0.1:8000/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Express应用index.js核心配置 #

app.set("views", path.join(__dirname, "views"));
app.use(passport.session());
app.set("view engine", "ejs");
initializePassport(passport);

视图渲染路由代码 #

app.get("/login", (req, res) => {
res.render("login");
});

项目文件夹结构 #

排查与解决步骤 #

1. 确认视图路径绝对正确性
   在生产环境的index.js中添加日志打印，输出视图路径的实际值：

   console.log("Views path:", path.join(__dirname, "views"));
   

   启动应用后查看日志，对比服务器上实际的views文件夹路径是否一致。若路径不符，检查进程启动的工作目录（比如pm2启动时的cwd设置）是否与应用根目录匹配。

2. 检查文件权限
   确保运行Node进程的用户拥有views文件夹及EJS文件的读取权限，执行以下命令：

   sudo chown -R $USER:$USER /path/to/your/app/views
   sudo chmod -R 755 /path/to/your/app/views
   

3. 验证EJS依赖安装状态
   进入应用根目录，检查生产环境是否安装了EJS依赖：

   npm list ejs
   

   若未安装，执行npm install ejs --save（生产环境需将依赖添加到dependencies而非devDependencies）。

4. 核对视图文件名与扩展名
   确认views文件夹内的目标文件为login.ejs，res.render("login")会自动匹配.ejs扩展名，文件名不符会导致加载失败。

5. 检查Nginx请求转发日志
   查看Nginx访问日志和错误日志（路径通常为/var/log/nginx/access.log、/var/log/nginx/error.log），确认请求是否正确转发至Node服务的8000端口。

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