MERN项目遇503错误、CORS拦截及服务器启动异常求助

问题概述 #

• 本地开发时网络面板返回503 Service Unavailable错误，控制台提示CORS origin被拦截
• 执行npm start启动后端服务器后，服务器短暂运行即断开连接
• 部署到Heroku后同样出现错误
• 已尝试多种CORS配置均无效，错误配置示例：

// 尝试过的配置1（存在重复赋值错误）
const corsOptions = {
  origin: ["http://localhost:3000"],
  origin: true, // 重复赋值覆盖了前面的数组，导致配置失效
  credentials: true,
};
app.use(cors(corsOptions));

// 尝试过的配置2
app.use(cors({ origin: "*" }));

// 尝试过的配置3
app.use(cors());

分步排查与解决 #

1. 修复服务器启动后崩溃问题 #

服务器短暂运行就断开，核心原因是未捕获异常或基础配置错误：

• 新增全局错误捕获，定位崩溃原因：

// 在server.js末尾添加
process.on('uncaughtException', (err) => {
  console.error('未捕获异常:', err);
  process.exit(1);
});

process.on('unhandledRejection', (reason) => {
  console.error('未处理Promise拒绝:', reason);
  process.exit(1);
});

• 检查端口占用：确认后端端口（如5000）未被其他进程占用，Windows用netstat -ano | findstr :5000，macOS/Linux用lsof -i :5000，杀掉对应PID后重启服务器。
• 验证数据库连接：确认MongoDB URI配置正确，本地开发时需确保MongoDB服务已启动。

2. 修复CORS拦截问题 #

修正之前的配置错误，根据场景选择对应方案：

• 本地开发固定允许前端端口：

const corsOptions = {
  origin: "http://localhost:3000", // 避免重复赋值
  credentials: true,
  optionsSuccessStatus: 200
};
app.use(cors(corsOptions));

• 动态允许多来源（适配本地+Heroku部署）：

const allowedOrigins = ['http://localhost:3000', 'https://你的Heroku应用域名.herokuapp.com'];
const corsOptions = {
  origin: (origin, callback) => {
    // 允许无origin的请求（如Postman测试）
    if (!origin || allowedOrigins.includes(origin)) {
      callback(null, true);
    } else {
      callback(new Error('Not allowed by CORS'));
    }
  },
  credentials: true
};
app.use(cors(corsOptions));

注意：如果前端Axios请求设置了withCredentials: true，后端origin不能设为*，二者无法同时生效。

3. 解决503错误 #

503本质是服务器未正常提供服务，先确保后端稳定启动后：

• 校验前端Axios请求URL：确认请求地址为http://localhost:5000/api/xxx（对应后端端口和路由），避免域名或端口错误。
• 检查后端路由定义：确认server.js中存在对应API路由，比如app.get('/api/products', ...)是否正确实现。

4. Heroku部署问题排查 #

• 确认package.json脚本配置正确：

{
  "scripts": {
    "start": "node server.js",
    "dev": "nodemon server.js"
  }
}

• 适配Heroku端口分配：后端需读取环境变量端口，避免硬编码：

const PORT = process.env.PORT || 5000;
app.listen(PORT, () => console.log(`Server running on port ${PORT}`));

• 查看Heroku实时日志：执行heroku logs --tail定位错误，比如数据库连接失败、依赖缺失等。

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