Heroku部署Node.js项目出现H12请求超时503问题求助

从你提供的日志能看出几个关键现象：

• 项目根路径能正常响应，但文章列表接口（/api/blogs/posts、/api/blogs/posts/）触发Heroku H12超时错误，服务运行满30秒被强制中断
• 单篇文章接口（带ID的请求）虽耗时长达10秒，但能正常返回304状态码

具体排查方向 #

1. MongoDB查询性能瓶颈 #

单篇查询都要10秒，说明数据库查询本身存在性能问题，列表查询大概率因为数据量或无索引彻底超时：

• 检查posts集合是否为列表接口的查询/排序字段（比如createdAt、category等）建立了索引，无索引的全集合扫描在数据量增加后会急剧变慢
• 本地模拟生产环境的数据量，测试列表接口的响应时间，确认是否在本地就存在慢查询
• 再次核对MongoDB连接字符串：确保用的是Heroku环境变量配置的生产地址，而非本地数据库地址（本地能正常连接不代表生产环境连接逻辑正确）

2. 异步代码逻辑问题 #

列表接口超时很可能是异步操作未正确执行或阻塞：

• 检查/api/blogs/posts路由的处理函数，是否存在未捕获的Promise异常，导致请求一直处于挂起状态
• 确认是否使用async/await但未添加错误捕获，或者数据库查询Promise一直处于pending状态
• 排查是否有嵌套查询、循环调用数据库的冗余逻辑，这类操作会大幅增加响应时间

3. Heroku基础配置与资源限制 #

• 确认代码中是否通过process.env.PORT监听端口，而非固定端口（Heroku会动态分配端口，硬编码端口会导致服务无法正常对外提供）
• 尝试重启Dyno：执行heroku restart命令，免费Dyno偶尔会因资源占用过高出现响应异常
• 查看Heroku仪表盘的CPU、内存占用情况，确认是否存在资源过载

临时调试方案 #

在列表接口中添加调试日志，定位具体耗时环节：

app.get('/api/blogs/posts', async (req, res) => {
  console.log('[DEBUG] 开始处理文章列表请求');
  try {
    const startTime = Date.now();
    // 替换为你的实际查询逻辑
    const posts = await Post.find({}).sort({ createdAt: -1 });
    const cost = Date.now() - startTime;
    console.log(`[DEBUG] 查询完成，耗时${cost}ms，返回${posts.length}条数据`);
    res.json(posts);
  } catch (err) {
    console.error('[ERROR] 列表查询失败:', err);
    res.status(500).json({ message: '服务器内部错误' });
  }
});

重新部署后查看日志，就能明确是查询环节卡住，还是其他逻辑导致的超时。

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