Docker容器化Node后端调用API出现net::ERR_EMPTY_RESPONSE错误排查

一、网络连通性排查 #

• 容器网络互通校验
  如果MySQL是Docker容器运行，确保后端容器和MySQL容器在同一个Docker网络中。可通过docker network ls查看现有网络，启动容器时用--network参数指定同一网络；如果MySQL部署在宿主机，后端容器内不能用localhost访问，需替换为：
  • Windows/macOS：host.docker.internal
  • Linux：宿主机的局域网IP（如192.168.x.x）
• 端口与连通性测试
  进入后端容器执行以下命令验证MySQL端口是否可达：

  # 用telnet测试
  telnet <DB_HOST> <DB_PORT>
  # 或用nc工具
  nc -zv <DB_HOST> <DB_PORT>
  

  连接失败的话，先排查MySQL的端口映射规则、宿主机防火墙设置。

二、数据库权限与连接配置 #

• 用户访问权限修复
  本地MySQL用户通常仅允许localhost访问，Docker容器IP不在授权范围内，需添加远程访问权限：

  GRANT ALL PRIVILEGES ON your_database.* TO 'your_user'@'%' IDENTIFIED BY 'your_password';
  FLUSH PRIVILEGES;
  

  注：生产环境建议将%替换为特定IP段，避免过度授权。
• 连接池参数调整
  检查Node后端的数据库连接池配置，适当增加超时时间适配Docker环境的网络延迟：

  const pool = mysql.createPool({
    host: process.env.DB_HOST,
    user: process.env.DB_USER,
    password: process.env.DB_PASSWORD,
    database: process.env.DB_NAME,
    connectionLimit: 10,
    waitForConnections: true,
    timeout: 10000, // 单位：ms，增加超时阈值
    acquireTimeout: 10000
  });
  

• 开启MySQL日志排查
  开启MySQL通用查询日志，确认是否收到后端的连接/查询请求：
  在MySQL配置文件中添加：

  general_log = 1
  general_log_file = /var/log/mysql/general.log
  

  重启MySQL后查看日志，判断请求是否到达数据库层。

三、Docker环境变量与容器内测试 #

• 验证环境变量加载
  进入后端容器，打印环境变量确认配置正确：

  echo $DB_HOST $DB_PORT $DB_USER
  

  如果变量为空，检查docker run命令是否正确加载.env文件，比如--env-file ./path/to/.env的路径是否准确。
• 容器内直接测试数据库连接
  在后端容器中安装MySQL客户端，直接连接测试：

  # Debian/Ubuntu容器安装客户端
  apt update && apt install -y mysql-client
  # 连接数据库
  mysql -h $DB_HOST -u $DB_USER -p$DB_PASSWORD $DB_NAME
  # 执行测试查询
  SELECT 1;
  

  连接或查询失败则直接定位数据库问题；成功的话再排查代码逻辑。

四、代码层面异常捕获修复 #

• 补全数据库查询的错误处理
  检查pool.query的错误分支是否正确处理，确保错误时返回响应给前端，避免请求挂起：

  pool.query('SELECT * FROM your_table', (err, results) => {
    if (err) {
      // 必须打印错误日志，便于排查
      console.error('Database query error:', err);
      // 返回500错误给前端
      return res.status(500).json({ code: 500, message: 'Database error' });
    }
    res.status(200).json(results);
  });
  

• 捕获未处理的Promise拒绝
  如果用Promise风格的pool.query()，必须用try/catch或.catch()捕获错误：

  try {
    const results = await pool.query('SELECT * FROM your_table');
    res.status(200).json(results);
  } catch (err) {
    console.error('Query error:', err);
    res.status(500).json({ error: err.message });
  }
  

  启动Node进程时添加--unhandled-rejections=strict参数，强制抛出未处理的Promise错误，避免进程静默挂起。

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