You need to enable JavaScript to run this app. Lumen结合Docker安装LumenPassport后数据库迁移报2002连接拒绝错误
优惠活动
大模型
产品
解决方案
定价
更多

Lumen结合Docker安装LumenPassport后数据库迁移报2002连接拒绝错误

问题现象

基于 Lumen + Docker 开发的身份认证简易API,完成 LumenPassport 安装后执行数据库迁移触发报错:SQLSTATE[HY000] [2002] Connection refused (SQL: select * from information_schema.tables where table_schema = ms_api_shop)
报错参考截图:
错误截图

已完成排查项

  • 可通过 DBeaver 工具正常连接目标 MySQL 数据库
  • 此前搭建过同技术栈的 Lumen + Docker 项目,迁移、运行全程无异常
  • 已核对 MySQL 实例内的库列表,目标库 ms_api_shop 已存在

现有项目配置

docker-compose 配置

services:
  nginx:
    build:
      context: .
      dockerfile: docker/Nginx.Dockerfile
    image: nginx
    ports:
      - 8092:80
    depends_on:
      - fpm
    volumes:
      - ./:/var/www/lumen-docker
    links:
      - mysql

  fpm:
    build:
      context: .
      dockerfile: docker/fpm.Dockerfile
    volumes:
      - ./:/var/www/lumen-docker
    depends_on:
      - mysql
    links:
      - mysql

  mysql:
    image: mysql:5.7
    ports:
      - 33006:3306
    environment:
      - MYSQL_ROOT_PASSWORD=
      - MYSQL_DATABASE=ms_api_shop
      - MYSQL_ROOT_USER=
    volumes:
      - mysql-data:/var/lib/mysql
volumes:
  mysql-data:

项目数据库环境配置(.env)

DB_HOST=mysql
DB_PORT=33006
DB_DATABASE=ms_api_shop
DB_USERNAME=
DB_PASSWORD=

问题根因与修复方案

触发连接拒绝的核心是两个配置错位,完全匹配你遇到的"宿主机工具能正常连、容器内程序连不上"的现象:

  1. 容器网络的端口匹配错误
    docker-compose里配置的33006:3306是宿主机到容器的端口映射,只对从宿主机发起的访问生效。fpm容器和mysql容器同属Docker内部网络,访问mysql服务时是直连容器内部的服务端口,完全不经过宿主机的端口映射规则,mysql容器内部对外提供服务的端口永远是3306。你现在在.env里配置DB_PORT=33006,相当于在mysql容器里找33006端口的服务,根本没有进程监听这个端口,自然触发连接拒绝。
  2. 数据库凭证配置不匹配
    mysql服务的环境变量里把MYSQL_ROOT_PASSWORD、MYSQL_ROOT_USER留空,会导致容器初始化时使用默认值生成账号体系,和你.env里留空的凭证配置对不上,即使端口改对也会出现认证失败。

具体操作步骤

  • 修改.env的数据库端口项:把DB_PORT=33006调整为DB_PORT=3306
  • 补全mysql服务的环境变量配置,不要留空:
    mysql:
      image: mysql:5.7
      ports:
        - 33006:3306
      environment:
        - MYSQL_ROOT_PASSWORD=设置一个明确的数据库密码
        - MYSQL_DATABASE=ms_api_shop
        - MYSQL_ROOT_USER=root
      volumes:
        - mysql-data:/var/lib/mysql
    
  • 把上面设置的账号、密码同步填写到项目.env的DB_USERNAME、DB_PASSWORD配置项中,保证两边凭证完全一致
  • 注意:原有的mysql-data卷是之前空配置下初始化的,空密码的环境变量不会在已有数据卷上生效,需要先删除旧数据卷再重新启动容器初始化mysql,否则配置不会生效。

内容的提问来源于stack exchange,提问作者Greedy Pointer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 00:36:03