Heroku MySQL连接错误与请求超时排查：前端POST对接后端失败

开发者阿泽

2026-10-2

问题1：服务监听8000端口而非Heroku指定端口的原因与修复

这是因为环境变量读取大小写不匹配导致的：
Heroku分配的服务端口存储在全大写的PORT环境变量中，而你的代码里写的是process.env.Port（首字母大写，其余小写），Node.js读取环境变量是大小写敏感的，所以无法正确获取到Heroku分配的端口值，直接触发了|| 8000的兜底逻辑，监听了8000端口。
修复方案：将端口声明行修改为

const port = process.env.PORT || 8000

修改后重新部署，Heroku就能正确识别到你的服务监听端口，解决基础的路由可达问题。

问题2：请求超时的其他可能原因与排查方向

数据库连接配置排查
你此前的日志显示服务尝试连接本地127.0.0.1的3306端口，虽然你已经配置了ClearDB，需要确认你的数据库连接代码没有硬编码本地数据库地址，所有连接参数（host、端口、用户名、密码、库名）都要从Heroku配置的对应环境变量中读取。
服务启动逻辑优化
建议在端口监听前添加数据库连接测试，捕获连接错误并打印到日志中，避免数据库连接失败导致服务无响应：

// 示例数据库连接测试逻辑，根据你的mysql2写法调整
const mysql = require('mysql2/promise');
const pool = mysql.createPool({
  host: process.env.CLEARDB_DATABASE_HOST,
  user: process.env.CLEARDB_DATABASE_USER,
  password: process.env.CLEARDB_DATABASE_PASSWORD,
  database: process.env.CLEARDB_DATABASE_DB,
  waitForConnections: true,
  connectionLimit: 10,
  queueLimit: 0
});

// 测试连接后再启动服务
pool.getConnection()
  .then(conn => {
    conn.release();
    app.listen(port, () => {
      console.log(`server is listening on ${port}, database connected`);
    });
  })
  .catch(err => {
    console.error('database connect failed:', err);
    process.exit(1);
  });