cPanel部署Node.js应用时缺少Passenger.log与stderr.log文件如何解决

手动创建日志文件并配置权限 #

• 首先通过SSH或者主机提供的文件管理器进入你Node.js应用的根目录，手动创建两个日志文件，执行命令：
  touch stderr.log passenger.log
• 给日志文件开放可写权限，共享主机一般运行应用的用户是www-data或者对应主机的运行用户，优先执行：
  chmod 664 stderr.log passenger.log
  如果权限还是不够，可临时设为666测试（后续排查完错误建议改回更安全的权限）：
  chmod 666 stderr.log passenger.log

配置日志输出路径 #

Passenger 日志配置 #

如果你的主机用Passenger作为应用服务器，在应用根目录下创建/编辑.htaccess文件（Apache环境）或者对应的Nginx自定义配置片段（如果主机开放配置权限），添加以下规则：

PassengerLogFile /你的应用绝对路径/passenger.log
PassengerLogLevel 3

注意把路径替换成你实际的应用根目录绝对路径，不知道路径的话可以在应用入口文件临时加一行console.log(__dirname)，访问应用后就能在临时输出里拿到完整路径。

Node.js stderr 日志配置 #

在应用的入口文件（比如app.js/index.js）最开头添加以下代码，手动把标准错误流写入到你创建的stderr.log里：

const fs = require('fs');
const errStream = fs.createWriteStream(`${__dirname}/stderr.log`, { flags: 'a' });
const originalStderrWrite = process.stderr.write;
process.stderr.write = (chunk, encoding, callback) => {
  errStream.write(chunk, encoding, callback);
  originalStderrWrite.call(process.stderr, chunk, encoding, callback);
};
// 额外捕获未处理的异常写入日志
process.on('uncaughtException', (err) => {
  errStream.write(`[${new Date().toISOString()}] Uncaught Exception: ${err.stack}\n`);
  process.exit(1);
});
process.on('unhandledRejection', (reason, promise) => {
  errStream.write(`[${new Date().toISOString()}] Unhandled Rejection at: ${promise}, reason: ${reason.stack || reason}\n`);
});

验证日志是否生效 #

配置完成后重启你的Node.js应用（可以通过主机面板的重启应用按钮，或者修改package.json文件触发Passenger自动重启），故意写一个报错代码触发错误，查看你创建的两个日志文件是否有内容写入。

共享主机特殊场景兼容 #

• 部分共享主机会限制自定义Passenger配置，你可以尝试在应用启动命令里手动指定日志输出，比如把package.json的start脚本修改为：
  "start": "node index.js 2>> /你的应用绝对路径/stderr.log"
• 如果主机不允许修改Passenger相关配置，也可以用第三方日志库替代原生console输出，所有错误都主动写入你指定的日志文件即可。

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