如何修复Heroku应用State changed from up to crashed（Mongoose连接错误）

该报错本质是Mongoose与MongoDB实例的TCP连接被意外断开后，缺少重连机制、未捕获连接异常导致Node进程直接退出，结合Heroku运行环境特性，通常由以下问题叠加导致：

• 数据库IP白名单未放行Heroku动态出口IP，连接会被MongoDB侧周期性拦截
• Mongoose连接未配置容错、重连规则，连接断开后直接抛出未捕获异常终止进程
• 服务启动逻辑未等待数据库连接成功就监听端口，连接初始化阶段的异常直接导致进程崩溃
• Procfile格式不规范，可能导致启动时环境变量加载异常

1. 修复数据库连接逻辑，增加异常捕获和重连配置 #

修改config/db.js的连接代码，适配Mongoose 6.x默认参数，增加重连、超时、异常捕获逻辑：

const mongoose = require('mongoose');

const connectDB = async () => {
  try {
    // 适配云环境网络波动的连接配置
    const conn = await mongoose.connect(process.env.MONGO_URI, {
      serverSelectionTimeoutMS: 5000, // 服务器选择超时5秒
      socketTimeoutMS: 45000, // Socket超时45秒，适配Heroku 55秒空闲连接断开规则
      family: 4, // 强制使用IPv4，避免Heroku环境IPv6解析异常
      maxPoolSize: 10, // 连接池大小适配免费dyno配置
      autoIndex: process.env.NODE_ENV !== 'production' // 生产环境关闭自动建索引减少性能开销
    });

    console.log(`MongoDB Connected: ${conn.connection.host}`);

    // 监听连接异常事件，避免未捕获错误触发崩溃
    mongoose.connection.on('error', err => {
      console.error(`MongoDB connection error: ${err}`);
    });

    // 监听连接断开事件，自动触发重连
    mongoose.connection.on('disconnected', () => {
      console.warn('MongoDB disconnected, attempting reconnection...');
      connectDB();
    });

  } catch (err) {
    console.error(`Database connection failed: ${err.message}`);
    // 连接失败时退出进程，让Heroku自动重启重试，避免僵死进程
    process.exit(1);
  }
};

module.exports = connectDB;

2. 调整服务启动逻辑，等待数据库连接成功后再监听端口 #

修改server.js的启动逻辑，不要在调用connectDB()后立刻启动服务，改为等待连接成功后再启动，避免初始化阶段的连接异常直接崩溃：

const express = require('express')
const morgan = require('morgan')
const cors = require('cors')
const connectDB = require('./config/db')
const passport = require('passport')
const bodyParser = require('body-parser')
const routes = require('./routes/index')

const app = express()

if(process.env.NODE_ENV === 'development') {
    app.use(morgan('dev'))
}

app.use(cors())
app.use(bodyParser.urlencoded({extended: false}))
app.use(bodyParser.json())
app.use(passport.initialize())
require('./config/passport')(passport)
app.use(routes)

const PORT = process.env.PORT || 3000

// 先连接数据库，成功后再启动服务
const startServer = async () => {
  try {
    await connectDB();
    app.listen(PORT, () => console.log(`Server running in ${process.env.NODE_ENV} mode on port ${PORT}`));
  } catch (err) {
    console.error('Server start failed:', err);
    process.exit(1);
  }
};

startServer();

// 全局捕获未处理的Promise异常，避免进程意外退出
process.on('unhandledRejection', (err) => {
  console.error('Unhandled Rejection:', err);
});

3. 修复MongoDB白名单配置 #

Heroku的dyno出口IP是动态变化的，固定IP白名单规则会导致周期性连接被拦截：

• 如果使用MongoDB Atlas，进入集群的Network Access配置，添加0.0.0.0/0允许所有IP访问（Atlas本身有账号密码鉴权，无额外安全风险）
• 如果是自建MongoDB实例，配置安全组允许Heroku的IP段访问，或者在Heroku上为应用绑定固定出口IP插件

4. 修正Procfile格式 #

当前Procfile的web:node server缺少冒号后的空格，且未指定文件后缀，修改为：

web: node server.js

5. 校验环境变量配置 #

执行heroku config确认MONGO_URI环境变量配置正确，注意连接字符串中如果包含特殊字符，需要做URL编码，避免解析失败导致连接异常。

• 提交上述代码修改后推送到Heroku远程仓库
• 执行heroku logs --tail观察启动日志，确认出现MongoDB连接成功、服务启动成功的日志
• 持续观察10分钟以上，确认不会再出现连接断开导致的崩溃问题
• 如果还是偶发断开，检查MongoDB实例的连接数上限，免费层Atlas连接数上限较低，将maxPoolSize参数调整到5即可

内容的提问来源于stack exchange，提问作者pomoworko.com