Spring Boot 使用 docker compose 时无法连接 MySQL,如何排查?
给出的 jdbc:mysql://db:3306/i_am_biker_db 适用于同一 Compose 网络中的服务,地址本身没有明显问题。先确认 Spring Boot 是否实际使用了这组连接参数,以及 MySQL 是否已完成初始化并能接受连接。
仅凭当前配置和错误信息,还无法确定具体原因。服务运行中、成功注册到 Eureka 或登录页面可以访问,都不能证明数据库连接正常。401 Unauthorized 的原因也需要结合认证服务日志判断。
确认容器使用的地址和 Spring Boot 配置
3307:3306 将宿主机的 3307 端口映射到数据库容器的 3306 端口。访问地址取决于客户端所在的位置:
| 访问位置 | 数据库地址 |
|---|---|
| 同一 Compose 网络中的 Spring Boot 容器 | db:3306 |
| Docker 宿主机上的客户端 | 127.0.0.1:3307 |
应用容器中的 localhost 指向应用容器自身。这里应继续使用 db:3306,不需要改成 db:3307。
还要检查环境变量名称。Spring Boot 标准数据源属性对应的环境变量是:
SPRING_DATASOURCE_URL: jdbc:mysql://db:3306/i_am_biker_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
SPRING_DATASOURCE_USERNAME: biker
SPRING_DATASOURCE_PASSWORD: ${DB_PASSWORD}
原配置使用了 DATASOURCE_URL 和 DATASOURCE_USERNAME。应用需要显式读取这些变量,才会将它们用于数据源,例如:
spring:
datasource:
url: ${DATASOURCE_URL}
username: ${DATASOURCE_USERNAME}
password: ${DB_PASSWORD}
如果应用已有这样的映射,可以保留原变量名称;如果使用 Spring Boot 默认数据源自动配置,建议直接使用 SPRING_DATASOURCE_*。如果应用自行创建 DataSource,则要检查配置类实际读取了哪些属性。
目前没有提供应用的 YAML 配置,无法断定变量是否生效。.env 的具体内容也不明确,因此不能仅凭 Compose 片段中缺少数据源密码,就认定容器没有密码。
等待 MySQL 真正就绪
原配置中的短格式 depends_on 控制启动顺序,但不会等待 MySQL 完成初始化。首次启动并创建数据库和用户时,数据库容器可能已经运行,应用却还无法建立连接。
可以为 db 添加健康检查,并让访问数据库的服务等待 service_healthy。将以下片段合并到原配置中,继续保留其他服务定义:
services:
db:
image: mysql:latest
ports:
- "3307:3306"
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
MYSQL_DATABASE: i_am_biker_db
MYSQL_USER: biker
MYSQL_PASSWORD: ${DB_PASSWORD}
volumes:
- mysql-data:/var/lib/mysql
healthcheck:
test:
- CMD-SHELL
- >-
mysql --protocol=TCP -h 127.0.0.1
-u"$${MYSQL_USER}" -p"$${MYSQL_PASSWORD}"
"$${MYSQL_DATABASE}" -e "SELECT 1" >/dev/null 2>&1
interval: 10s
timeout: 5s
retries: 12
start_period: 30s
bikes-service:
build: ./bikes-service
depends_on:
eureka-server:
condition: service_started
db:
condition: service_healthy
env_file:
- .env
environment:
EUREKA_CLIENT_SERVICEURL_DEFAULTZONE: "http://eureka-server:8761/eureka/"
SPRING_DATASOURCE_URL: jdbc:mysql://db:3306/i_am_biker_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
SPRING_DATASOURCE_USERNAME: biker
SPRING_DATASOURCE_PASSWORD: ${DB_PASSWORD}
authentication-service:
build: ./authentication-service
ports:
- "8900:8900"
depends_on:
eureka-server:
condition: service_started
db:
condition: service_healthy
env_file:
- .env
environment:
EUREKA_CLIENT_SERVICEURL_DEFAULTZONE: "http://eureka-server:8761/eureka/"
SPRING_DATASOURCE_URL: jdbc:mysql://db:3306/i_am_biker_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
SPRING_DATASOURCE_USERNAME: biker
SPRING_DATASOURCE_PASSWORD: ${DB_PASSWORD}
volumes:
mysql-data:
这里用 SELECT 1 检查目标数据库和用户是否能正常执行 SQL。$$ 避免 Compose 提前展开变量,让容器内的 shell 读取 MYSQL_USER、MYSQL_PASSWORD 和 MYSQL_DATABASE。检查时间参数只是示例,应根据实际初始化耗时调整。
健康检查只能解决启动时的等待问题。如果数据库运行期间重启或断连,应用和连接池仍需要具备相应的连接恢复能力。
用日志和连接测试缩小范围
先检查实际配置和运行状态:
docker compose config
docker compose ps
docker compose logs --tail=200 db authentication-service bikes-service
docker compose config 可以发现 YAML 结构错误,并显示变量展开后的配置。输出可能包含密码,分享前应脱敏。
问题中粘贴的 YAML 没有层级缩进。如果实际文件也是如此,需要修正;如果只是粘贴时丢失了缩进,以本地文件的校验结果为准。
查看应用日志时,继续追踪 JDBC 异常后面的 Caused by。例如,遇到 Connection refused 可检查监听端口和就绪状态;遇到 UnknownHostException 可检查名称解析和网络;遇到 Access denied for user 则要检查密码和账户权限。当前的“未收到任何数据包”信息不足以直接判定为密码错误。
接着在数据库容器内测试 TCP 连接:
docker compose exec db mysql --protocol=TCP -h db -P 3306 -u biker -p i_am_biker_db -e "SELECT 1;"
按提示输入 biker 的密码。这一步可以验证数据库是否接受该账户访问目标库,但还不能验证应用容器到数据库的网络路径。
如果应用镜像包含相应工具,可继续执行:
docker compose exec authentication-service getent hosts db
docker compose exec authentication-service nc -vz db 3306
getent 用于检查名称解析,nc 用于检查 TCP 端口。如果提示命令不存在,只说明镜像未安装该工具。端口测试成功后,仍需通过实际 JDBC 连接验证驱动、账户和应用配置。
检查 .env 与持久化数据卷
Compose 中的 .env 有两种需要区分的用途:
${DB_PASSWORD}由 Compose 在解析配置时展开;默认.env或 shell 环境可以提供这个值。env_file: .env将文件中的变量传给指定服务的容器。
即使文件中存在 DB_PASSWORD,Spring Boot 也不会自动把它当作 spring.datasource.password。需要在应用 YAML 中引用它,或显式设置 SPRING_DATASOURCE_PASSWORD。
mysql-data:/var/lib/mysql 会保留数据库数据。MySQL 镜像的 MYSQL_DATABASE、MYSQL_USER 和 MYSQL_PASSWORD 等设置主要用于首次初始化空数据目录。已有数据卷时,修改 .env 中的密码不会自动更新数据库中既有用户的密码。
如果数据库已经初始化过,应使用现有管理员凭据检查 biker 账户、匹配的 Host 和授权,再按实际情况更新。不要把删除数据卷当成常规修复步骤;docker compose down -v 会删除相关数据卷及其中的数据库数据。
示例沿用了原配置的 mysql:latest。为了让部署可复现,实际配置宜固定到已验证兼容的 MySQL 版本,并确认 JDBC 驱动与其兼容。当前信息不足以判断是否存在版本兼容问题。
数据库连接恢复后再定位 401
数据库故障可能导致认证服务无法读取用户凭据,但是否最终返回 401 Unauthorized,取决于认证逻辑和异常处理。仅凭这个状态码,不能确定数据库是唯一原因。
确认 JDBC 已能连接后,检查登录请求对应的服务日志,并核对:
- 容器中的
i_am_biker_db是否包含预期用户记录。本机原有数据库的数据不会因为启动 Compose 自动复制过来。 - 存储的密码格式是否与当前使用的密码校验方式一致。
- 请求是否到达预期认证接口,网关路由、认证头和 Spring Security 配置是否符合接口要求。
如果直接访问认证服务与经过 API Gateway 的结果不同,应结合请求路径和两端日志继续定位。登录页面能打开,只能说明页面访问链路可用,不能替代数据库连接和认证流程的验证。
备注:内容仅供参考。
