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=
问题根因与修复方案
触发连接拒绝的核心是两个配置错位,完全匹配你遇到的"宿主机工具能正常连、容器内程序连不上"的现象:
- 容器网络的端口匹配错误
docker-compose里配置的33006:3306是宿主机到容器的端口映射,只对从宿主机发起的访问生效。fpm容器和mysql容器同属Docker内部网络,访问mysql服务时是直连容器内部的服务端口,完全不经过宿主机的端口映射规则,mysql容器内部对外提供服务的端口永远是3306。你现在在.env里配置DB_PORT=33006,相当于在mysql容器里找33006端口的服务,根本没有进程监听这个端口,自然触发连接拒绝。 - 数据库凭证配置不匹配
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
相关产品推荐
相关产品推荐

