Wildfly Docker容器连接MySQL Docker容器通信链路故障排查

一、数据库连接失败（CommunicationsException、Unable to determine Dialect） #

核心排查与解决： #

• 修正JDBC URL：容器内不能用localhost访问MySQL容器，必须使用docker-compose中MySQL服务的名称（比如你定义的服务名是mysql，则URL应为jdbc:mysql://mysql:3306/你的数据库名?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true）。容器间通过服务名通信，localhost在Wildfly容器中指向自身，而非MySQL容器。
• 调整启动顺序：Wildfly可能比MySQL先启动，导致数据库未就绪时连接失败。在docker-compose中给Wildfly配置依赖健康检查：

  services:
    mysql:
      image: mysql:8.0
      healthcheck:
        test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
        interval: 5s
        timeout: 5s
        retries: 5
    wildfly:
      build: ./wildfly
      depends_on:
        mysql:
          condition: service_healthy
  

• 验证MySQL配置：确认MySQL容器的环境变量（MYSQL_ROOT_PASSWORD、MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD）与Wildfly数据源配置完全一致，且目标数据库已正常创建。
• 手动指定Hibernate方言：在persistence.xml的持久化单元中明确添加方言配置，避免自动检测失败：

  <property name="hibernate.dialect" value="org.hibernate.dialect.MySQL8Dialect"/>
  

• 检查Wildfly驱动：确保Wildfly容器中已正确添加MySQL JDBC驱动模块，standalone.xml的数据源配置中driver-class-name为com.mysql.cj.jdbc.Driver，驱动模块名称（如com.mysql）配置正确。

二、部署成功但访问404 #

核心排查与解决： #

• 确认上下文根：Wildfly默认以war包名称（去掉.war后缀）作为上下文根。比如你的war包是my-jakarta-app.war，则访问路径应为localhost:8080/my-jakarta-app/你的REST路径，而非直接localhost:8080/你的REST路径。若需根路径，可在jboss-web.xml中自定义：

  <jboss-web>
    <context-root>/</context-root>
  </jboss-web>
  

• 验证端口映射：检查docker-compose中Wildfly的端口映射是否正确，确保配置为ports: - "8080:8080"，主机8080端口已映射到容器8080端口。
• 核对REST路径注解：确认REST服务类的@Path注解是否正确，比如@Path("/api/users")，则完整访问路径应为localhost:8080/上下文根/api/users。
• 查看部署日志：检查Wildfly容器日志，确认是否输出类似Registered web context: '/my-jakarta-app'的信息，验证上下文根是否符合预期。

内容的提问来源于stack exchange，提问作者user30244094