Node.js+MySQL项目迁移Docker后数据库连接失败问题咨询

核心疑问 #

• 停止本地3306端口的MySQL连接是否会影响Docker化应用的运行？
• Docker容器如何替代原有本地数据库连接？
• 解决当前连接失败问题的正确步骤是什么？

问题根源分析 #

从错误日志Error: connect ECONNREFUSED 127.0.0.1:3307可以定位核心问题：

1. Node容器试图连接自身容器内的3307端口（Docker容器内的localhost指向容器自身，而非宿主机或MySQL容器）
2. .env文件中DB_HOST=localhost的配置覆盖了Dockerfile中定义的mysql-container数据库地址
3. docker-compose.yaml中服务器端口映射错误（容器内服务器运行在3000端口，却配置了3001:3001）
4. DBConnection.js未读取环境变量中的端口配置，且未显式指定端口参数

疑问解答 #

1. 停止本地3306端口连接是否影响应用？ #

不会影响。Docker容器中的MySQL是独立运行的实例，与本地MySQL完全隔离。只要应用通过Docker内部网络连接容器化数据库，本地MySQL的启停对Docker化应用无任何影响。

2. Docker容器如何替代原有连接？ #

Docker Compose会自动为所有服务创建专属内部网络：

• 容器之间可直接通过服务名称（如mysql-container）互相访问，无需依赖宿主机端口映射
• 宿主机的端口映射（如3307:3306）仅用于外部工具（如MySQL Workbench）连接容器内的数据库，容器间通信不需要走这个映射

正确解决步骤 #

步骤1：修正环境变量配置（.env） #

将DB_HOST改为Docker Compose中MySQL服务的名称，并补充端口配置：

DB_HOST=mysql-container
DB_USER=root
DB_PASSWORD=...
DB_NAME=...
DB_PORT=3306

步骤2：修正数据库连接代码（DBConnection.js） #

添加port字段，读取环境变量中的端口配置：

const mysql = require("mysql2");

const db = mysql.createConnection({
  host: process.env.DB_HOST || "localhost",
  user: process.env.DB_USER || "root",
  password: process.env.DB_PASSWORD || "pass",
  database: process.env.DB_NAME || "DBName",
  port: process.env.DB_PORT || 3306 // 新增端口配置
});

module.exports = db;

步骤3：修正Docker Compose端口映射（compose.yaml） #

将服务器的端口映射改为3001:3000（容器内服务器实际运行在3000端口）：

version: '3'
services:
  server-container:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "3001:3000" # 修正端口映射
    depends_on:
      - mysql-container

  mysql-container:
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: pass
      MYSQL_DATABASE: DBName
      MYSQL_ALLOW_EMPTY_PASSWORD: "no"
    ports:
      - "3307:3306" # 此映射仅用于外部工具连接

步骤4：重新构建并启动容器 #

执行以下命令重启服务：

docker-compose down
docker-compose up --build

步骤5：用MySQL Workbench连接容器数据库 #

如果需要用Workbench管理容器内的数据库，连接参数设置为：

• 主机：127.0.0.1
• 端口：3307
• 用户名：root
• 密码：pass（对应compose中MYSQL_ROOT_PASSWORD）

附：用户提供的原始配置文件 #

Dockerfile #

ARG NODE_VERSION=18.14.0
ARG DB_HOST=mysql-container
ARG DB_PORT=3306
ARG DB_USER=root
ARG DB_PASSWORD=...
ARG DB_NAME=...


FROM node:${NODE_VERSION}-alpine

ENV DB_HOST=$DB_HOST
ENV DB_PORT=$DB_PORT
ENV DB_USER=$DB_USER
ENV DB_PASSWORD=$DB_PASSWORD
ENV DB_NAME=$DB_NAME

ENV NODE_ENV production


WORKDIR /...
RUN --mount=type=bind,source=package.json,target=package.json \
    --mount=type=bind,source=package-lock.json,target=package-lock.json \
    --mount=type=cache,target=/root/.npm \
    npm ci --omit=dev

USER node

COPY ...

EXPOSE 3000

CMD npm start

错误日志 #

backend-server-container-1  |
backend-server-container-1  | > backend@1.0.0 start
backend-server-container-1  | > node server.js
backend-server-container-1  |
backend-server-container-1  | Server started 3000
backend-server-container-1  | node:events:491
backend-server-container-1  |       throw er; // Unhandled 'error' event
backend-server-container-1  |       ^
backend-server-container-1  |
backend-server-container-1  | Error: connect ECONNREFUSED 127.0.0.1:3307
backend-server-container-1  |     at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1494:16)
backend-server-container-1  | Emitted 'error' event on Connection instance at:
backend-server-container-1  |     at Connection._notifyError (/backend/node_modules/mysql2/lib/connection.js:252:12)
backend-server-container-1  |     at Connection._handleFatalError (/backend/node_modules/mysql2/lib/connection.js:183:10)
backend-server-container-1  |     at Connection._handleNetworkError (/backend/node_modules/mysql2/lib/connection.js:196:10)
backend-server-container-1  |     at Socket.emit (node:events:513:28)
backend-server-container-1  |     at emitErrorNT (node:internal/streams/destroy:151:8)
backend-server-container-1  |     at emitErrorCloseNT (node:internal/streams/destroy:116:3)
backend-server-container-1  |     at process.processTicksAndRejections (node:internal/process/task_queues:82:21) {
backend-server-container-1  |   errno: -111,
backend-server-container-1  |   code: 'ECONNREFUSED',
backend-server-container-1  |   syscall: 'connect',
backend-server-container-1  |   address: '127.0.0.1',
backend-server-container-1  |   port: 3307,
backend-server-container-1  |   fatal: true
backend-server-container-1  | }
backend-server-container-1  |
backend-server-container-1  | Node.js v18.14.0
backend-server-container-1  | npm notice
backend-server-container-1  | npm notice New major version of npm available! 9.3.1 -> 10.2.3
backend-server-container-1  | npm notice Changelog: <https://github.com/npm/cli/releases/tag/v10.2.3>
backend-server-container-1  | npm notice Run `npm install -g npm@10.2.3` to update!
backend-server-container-1  | npm notice
backend-server-container-1 exited with code 1

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