AWS EC2集成Winston的Node.js应用特定路由报502错误求助

核心现象分析 #

日志logger.info('Patient login request')能正常输出，说明请求已进入处理函数，但后续res.render环节出现未被捕获的异常，或环境权限/路径问题导致响应无法正常返回，最终触发502错误（通常是反向代理或负载均衡未收到应用的有效响应）。以下是具体排查步骤：

1. 捕获模板渲染的具体错误 #

修改请求处理函数，给res.render添加回调捕获渲染阶段的错误，这是最直接定位问题的方式：

exports.patientloginoptimized = (req, res, next) => {
    logger.info('Patient login request')
    res.render('patientViews/patientFront/patient-login-optimized', { title: "" }, (err) => {
        if (err) {
            logger.error('模板渲染错误:', err.stack);
            next(err); // 传递错误给全局错误处理中间件
        }
    })
}

查看Winston日志中的错误信息，大概率能找到模板文件不存在、语法错误或路径不匹配的问题（EC2是Linux系统，文件名区分大小写，而Heroku/本地可能不区分）。

2. 检查文件与目录权限 #

• 模板文件权限：用ls -l patientViews/patientFront/patient-login-optimized.*查看模板文件的权限，确保应用运行用户（比如ec2-user）有读取权限，必要时执行chmod 644 模板文件路径调整。
• Winston日志目录权限：手动创建日志目录并赋予写入权限：

  mkdir -p /path/to/your/app/logs
  chown -R ec2-user:ec2-user /path/to/your/app/logs
  

DailyRotateFile需要创建日志文件和压缩包，如果权限不足，会静默抛出未处理异常，导致请求挂起。

3. 排查全局未处理异常 #

添加全局错误捕获，捕获Winston或其他模块的未处理异常：

process.on('uncaughtException', (err) => {
    logger.error('未捕获异常:', err.stack);
    process.exit(1);
});

process.on('unhandledRejection', (reason, promise) => {
    logger.error('未处理Promise拒绝:', reason.stack);
});

这类异常可能导致进程无法正常响应请求，最终触发502。

4. 对比EC2与Heroku的环境差异 #

• Node.js版本：执行node -v确认EC2与Heroku的Node.js版本一致，版本差异可能导致兼容性问题。
• 磁盘空间：用df -h检查EC2磁盘是否已满，磁盘空间不足会导致Winston无法写入日志，进而阻塞请求。
• 反向代理配置：如果使用Nginx作为反向代理，检查Nginx配置是否正确指向Node.js进程的监听端口，以及Nginx的错误日志（/var/log/nginx/error.log）是否有连接超时或拒绝的记录。

5. 验证Winston是否为直接诱因 #

临时注释掉logger.info语句，重新测试路由：

• 如果路由恢复正常，说明Winston的日志写入操作存在阻塞或错误，可尝试调整Winston的配置（比如关闭zippedArchive临时测试，或更换日志存储路径）。
• 如果仍返回502，说明问题与Winston无关，聚焦模板渲染或EC2环境配置。

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