Docker部署Spring MVC应用时无法连接MySQL服务器问题咨询
核心报错根因
最底层的触发错误为java.net.UnknownHostException: mysql-standalone,说明应用容器无法通过服务名解析到MySQL容器的IP地址,本质是YAML语法缩进错误导致两个服务未接入同一docker-compose共享网络,叠加多层环境变量、端口配置、占位符定义错误,最终引发数据库连接失败。
逐点错误排查与修复方案
- docker-compose.yml 缩进语法错误(直接导致域名解析失效)
原配置中顶层version字段前多了2个前置空格,YAML解析器无法正确识别顶层配置结构,不会为两个服务创建共享的默认bridge网络,跨容器DNS解析直接失效。修复时需保证所有顶层字段(version、services)顶格书写,无前置空格。 - MySQL服务环境变量配置错误
原配置存在两处问题:- 列表形式定义环境变量时,等号两侧添加了空格(如
- MYSQL_ROOT_PASSWORD= root),实际读取到的配置值会包含前置空格(即密码为root而非root),导致鉴权失败。 - 重复定义
MYSQL_DATABASE单值变量,该配置仅支持指定一个初始化时自动创建的数据库名,重复定义只会保留最后一次配置值,无法自动创建两个独立库。多库创建需依赖挂载的初始化脚本执行CREATE DATABASE语句完成。
修复时需去掉环境变量值前后的多余空格,仅保留单份MYSQL_DATABASE配置,两个库的初始化交由挂载的SQL脚本处理。
- 列表形式定义环境变量时,等号两侧添加了空格(如
- 跨容器通信端口配置错误
原配置中应用连接MySQL使用宿主机映射端口3307。docker-compose默认网络下,容器间通信直接访问对方容器内部暴露的端口(MySQL容器内部固定监听3306),映射到宿主机的3307端口仅供宿主机进程访问,容器间通信无需使用映射端口,配置3307会导致域名解析正常时仍出现端口连接超时。
修复时需将应用侧的MySQL连接端口配置为容器内部端口3306,避免使用宿主机映射端口。 - application.properties 占位符配置错误
原配置存在两处占位符引用错误:- 第二数据库的库名配置项
dbdatabaseName.cth.chat.local错误引用用户名环境变量,无法正确读取库名配置。 - 第二数据库的端口配置项引用了未定义的
CTH_CHAT_PORT环境变量,仅靠本地默认值兜底,环境变量注入完全失效。
修复时需保证所有占位符名称与docker-compose中定义的环境变量名完全一致。
- 第二数据库的库名配置项
修复后的参考配置
docker-compose.yml
version: '3' services: mysql-standalone: image: 'mysql:5.7' command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci volumes: - ./docker/provision/mysql/init:/docker-entrypoint-initdb.d environment: MYSQL_ROOT_PASSWORD: root MYSQL_USER: root MYSQL_PASSWORD: root MYSQL_DATABASE: CTH ports: - "3307:3306" cth-docker-container: image: cth-docker-container ports: - "8082:8082" environment: CTH_DATASOURCE_DATABASE: CTH CTH_DATASOURCE_SERVERNAME: mysql-standalone CTH_DATASOURCE_USERNAME: root CTH_DATASOURCE_PASSWORD: root CTH_DATASOURCE_PORT: 3306 CTH_CHAT_DATASOURCE_DATABASE: CTH_CHAT CTH_CHAT_DATASOURCE_SERVERNAME: mysql-standalone CTH_CHAT_DATASOURCE_USERNAME: root CTH_CHAT_DATASOURCE_PASSWORD: root CTH_CHAT_DATASOURCE_PORT: 3306 build: context: "./" dockerfile: "Dockerfile" depends_on: - mysql-standalone
application.properties 数据库配置片段
# 第一数据库配置 dbuser.local=${CTH_DATASOURCE_USERNAME:root} dbpassword.local=${CTH_DATASOURCE_PASSWORD:root} dbdatabaseName.local=${CTH_DATASOURCE_DATABASE:CTH} dbserverName.local=${CTH_DATASOURCE_SERVERNAME:localhost} dbportNumber.local=${CTH_DATASOURCE_PORT:3306} # 第二数据库配置 dbuser.cth.chat.local=${CTH_CHAT_DATASOURCE_USERNAME:root} dbpassword.cth.chat.local=${CTH_CHAT_DATASOURCE_PASSWORD:root} dbdatabaseName.cth.chat.local=${CTH_CHAT_DATASOURCE_DATABASE:CTH_CHAT} dbserverName.cth.chat.local=${CTH_CHAT_DATASOURCE_SERVERNAME:localhost} dbportNumber.cth.chat.local=${CTH_CHAT_DATASOURCE_PORT:3306}
启动验证注意事项
- 启动前执行
docker-compose down --rmi local清理旧的应用镜像与网络缓存,避免旧配置残留导致的解析问题。 depends_on仅能保证MySQL容器进程启动,无法保证MySQL完成初始化并开放连接,若应用启动时仍出现连接超时,可在应用侧增加短周期的数据库重连逻辑,或通过健康检查配置联动服务启动顺序。- Tomcat默认监听8080端口,当前配置
8082:8082的端口映射无法正确访问应用,可调整Tomcat监听端口为8082,或将端口映射修改为8082:8080。
内容的提问来源于stack exchange,提问作者Shivam Patil
相关产品推荐
相关产品推荐

