部署NestJS Docker容器到Heroku时报Process exited with status 1错误如何解决

核心问题：日志配置导致进程启动失败 #

你的NestJS项目和可正常部署的空白项目的核心差异是你引入了nest-winston做日志落地，两个直接导致进程崩溃的点如下：

• 缺失日志存储目录：你配置Winston将日志写入logs/目录下的多个文件，但Node不会自动创建不存在的上级目录，且你的Dockerfile中没有预先创建该目录，Winston初始化时尝试写入不存在的路径会直接抛出ENOENT异常，导致进程退出，返回状态码1。你本地运行时大概率已经手动创建过logs目录，所以不会触发该错误。
• 无控制台日志输出：你当前的Winston配置仅配置了文件传输，没有配置控制台输出，所有启动报错都被写入了你没有权限访问的容器内部文件，导致你无法从Heroku日志面板看到具体错误信息，只能看到进程退出状态。
  另外Heroku容器的文件系统是临时的，即使你创建了logs目录，写入的日志也会在容器重启、重新部署时全部丢失，不符合Heroku的日志收集规则。

修复步骤 #

1. 先调整Winston配置，增加控制台输出，方便排查错误，参考修改：

transports: [
  // 生产环境优先输出到控制台，Heroku会自动收集所有stdout/stderr日志
  new transports.Console(),
  // 本地开发可保留文件输出，生产环境建议注释
  // new transports.File({
  //   filename: 'logs/portalInfo.log',
  //   level: "http",
  //   maxsize:10000000,
  //   maxFiles: 10
  // }),
  // new transports.File({ 
  //   filename: 'logs/portalError.log',
  //   level: "error",
  //   maxsize:10000000,
  //   maxFiles: 10 
  // }),
],

2. 给bootstrap函数增加错误捕获，打印启动异常到控制台：

async function bootstrap() {
  try {
    // 原有启动逻辑
  } catch (err) {
    console.error('应用启动失败:', err);
    process.exit(1);
  }
}

3. 如果你确实需要保留文件日志，在Dockerfile的production阶段增加创建日志目录的步骤：

WORKDIR /usr/src/app
RUN mkdir -p /usr/src/app/logs
COPY package*.json ./

4. 本地先运行生产构建的Docker镜像验证是否正常，再部署到Heroku，避免反复部署浪费时间：

docker build -t your-image-name .
docker run -p 3000:3000 -e PORT=3000 your-image-name

其他可能排查点 #

如果修改日志配置后仍然报错，检查你的ConfigService依赖的所有环境变量是否都已经在Heroku控制台的配置变量中完成配置，缺失必要的环境变量（如数据库连接地址、第三方服务密钥等）也会导致进程启动失败。

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