Docker环境下连接MySQL与Gogs容器时出现错误求助

看起来你在配置Gogs和MySQL容器互联时遇到了连接问题，我帮你梳理几个关键的问题点和修复方案：

1. MySQL用户配置的不合理之处 #

你的docker-compose.yml里给MySQL设置了MYSQL_USER=root，这是没必要的——root已经是默认的超级用户，重复声明不仅冗余，还可能导致权限逻辑混乱。建议创建一个专门给Gogs使用的数据库用户，比如gogs_user，这样权限更清晰也更安全。

2. Docker容器间的网络访问错误 #

在Docker Compose的默认网络中，容器之间是通过服务名称来通信的，而不是localhost。所以Gogs配置数据库的时候，主机地址应该填mysql（也就是你定义的MySQL服务名），而不是127.0.0.1或者localhost——后者会指向Gogs容器自己，自然连不上MySQL。

3. 确保MySQL完全就绪后再启动Gogs #

depends_on只是保证Gogs在MySQL之后启动，但不保证MySQL已经完成初始化并可以接受连接。你可以给MySQL服务加上健康检查，让Gogs等MySQL真正就绪后再启动：

修改后的完整docker-compose.yml配置 #

version: '3'
services:
  mysql:
    image: mysql:latest
    restart: always
    ports:
      - 3306:3306
    volumes:
      - ~/workspace/db:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=soextreme
      - MYSQL_USER=gogs_user  # 专门的Gogs用户
      - MYSQL_PASSWORD=gogs_pass  # 设置独立密码
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
      interval: 5s
      timeout: 5s
      retries: 5
  gogs:
    image: gogs/gogs:latest
    depends_on:
      mysql:
        condition: service_healthy  # 等待MySQL健康检查通过
    restart: always
    ports:
      - 3000:3000
      - "10022:22"
    volumes:
      - ~/workspace/gogs:/data

Gogs初始化时的数据库配置要点 #

当你访问Gogs的初始化页面（http://localhost:3000）时，数据库部分要填这些参数：

• 数据库类型：MySQL
• 主机：mysql:3306
• 用户：gogs_user（和docker-compose里的一致）
• 密码：gogs_pass（和docker-compose里的一致）
• 数据库名称：soextreme

额外排查步骤 #

如果还是连接失败，可以试试这些操作：

• 进入MySQL容器，检查用户权限：

  docker exec -it <mysql-container-id> mysql -uroot -proot
  # 执行SQL查看权限
  SELECT user, host FROM mysql.user WHERE user='gogs_user';
  # 确保host是%（允许任何地址访问），如果不是就授权
  GRANT ALL PRIVILEGES ON soextreme.* TO 'gogs_user'@'%';
  FLUSH PRIVILEGES;
  

• 检查Gogs容器的日志，看具体的错误信息：

  docker logs <gogs-container-id>
  

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