Express/Node应用本地与Docker容器连接MySQL的统一配置方案

当然有办法！不用每次改代码切换host，下面是几个实用的方案，按推荐程度排序：

1. 用环境变量（最推荐） #

这是Node.js项目管理多环境配置的标准做法，完全不需要修改代码，只需在不同环境下设置对应环境变量即可。

具体步骤： #

• 修改数据库连接代码，通过process.env动态读取配置：

const connection = mysql.createConnection({
    host: process.env.MYSQL_HOST || 'localhost', // 默认用localhost，兼容本地直接运行
    port: process.env.MYSQL_PORT || 3306,
    user: process.env.MYSQL_USER || 'user',
    password: process.env.MYSQL_PASSWORD || 'user-password'
});

• 本地开发时，用dotenv加载本地环境变量：
  先安装依赖：

npm install dotenv --save-dev

在项目根目录创建.env文件：

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=user
MYSQL_PASSWORD=user-password

最后在server.js最顶部添加加载逻辑：

require('dotenv').config();

这样本地运行node server.js时，会自动读取.env里的配置。

• Docker容器运行时，在docker-compose.yml中给应用服务配置环境变量：

services:
  my-app:
    image: <myimage>
    environment:
      - MYSQL_HOST=my-db
      - MYSQL_PORT=3306
      - MYSQL_USER=user
      - MYSQL_PASSWORD=user-password
    # 其他容器配置...
  my-db:
    image: mysql:latest
    # MySQL服务相关配置...

用docker-compose run my-app启动时，容器会自动使用my-db作为数据库host。

2. 统一网络配置（适合不想用环境变量的场景） #

如果不想维护环境变量，可以把本地和容器的MySQL访问方式统一：

针对Docker Desktop（Windows/Mac）： #

Docker内置了特殊域名host.docker.internal，容器中用这个域名可直接访问宿主机服务，同时本地代码用它也会解析到localhost。

直接把连接配置写死：

const connection = mysql.createConnection({
    host: 'host.docker.internal',
    port: 3306,
    user: 'user',
    password: 'user-password'
});

• 本地直接运行时，host.docker.internal指向localhost，正常连接本地MySQL；
• 容器运行时，该域名指向宿主机（若你的MySQL是docker-compose中的my-db容器，此方案不适用，更适合宿主机本地安装MySQL的场景）。

针对Linux系统： #

Linux默认不支持host.docker.internal，可在docker-compose.yml中手动配置：

services:
  my-app:
    image: <myimage>
    extra_hosts:
      - "host.docker.internal:host-gateway"
    # 其他容器配置...

配置后同样可以用host.docker.internal作为统一host。

3. 基于运行环境自动判断（不推荐，可靠性低） #

可以通过代码判断当前是否在Docker容器中，比如检查系统文件或环境变量，但这种方法依赖系统环境，容易出现误判，不如环境变量可靠。示例代码：

const fs = require('fs');

function isInDocker() {
  try {
    return fs.readFileSync('/proc/1/cgroup', 'utf8').includes('docker');
  } catch (e) {
    return false;
  }
}

const connection = mysql.createConnection({
    host: isInDocker() ? 'my-db' : 'localhost',
    port: 3306,
    user: 'user',
    password: 'user-password'
});

内容的提问来源于stack exchange，提问作者Frederick Scott Smith