You need to enable JavaScript to run this app. Docker部署Spring MVC应用时无法连接MySQL服务器问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

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服务环境变量配置错误
    原配置存在两处问题:
    1. 列表形式定义环境变量时,等号两侧添加了空格(如- MYSQL_ROOT_PASSWORD= root),实际读取到的配置值会包含前置空格(即密码为 root而非root),导致鉴权失败。
    2. 重复定义MYSQL_DATABASE单值变量,该配置仅支持指定一个初始化时自动创建的数据库名,重复定义只会保留最后一次配置值,无法自动创建两个独立库。多库创建需依赖挂载的初始化脚本执行CREATE DATABASE语句完成。
      修复时需去掉环境变量值前后的多余空格,仅保留单份MYSQL_DATABASE配置,两个库的初始化交由挂载的SQL脚本处理。
  • 跨容器通信端口配置错误
    原配置中应用连接MySQL使用宿主机映射端口3307。docker-compose默认网络下,容器间通信直接访问对方容器内部暴露的端口(MySQL容器内部固定监听3306),映射到宿主机的3307端口仅供宿主机进程访问,容器间通信无需使用映射端口,配置3307会导致域名解析正常时仍出现端口连接超时。
    修复时需将应用侧的MySQL连接端口配置为容器内部端口3306,避免使用宿主机映射端口。
  • application.properties 占位符配置错误
    原配置存在两处占位符引用错误:
    1. 第二数据库的库名配置项dbdatabaseName.cth.chat.local 错误引用用户名环境变量,无法正确读取库名配置。
    2. 第二数据库的端口配置项引用了未定义的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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.09 23:36:02