容器化ASP.NET Core 3.1应用无法连接本地MySQL数据库求助

核心问题定位 #

容器内的127.0.0.1指向容器自身，而非宿主机的MySQL服务，这是导致连接失败的最直接原因。

具体解决步骤 #

• 修正连接字符串的服务器地址
  • Windows/macOS环境：将连接字符串中的server=127.0.0.1替换为server=host.docker.internal，这个地址是Docker专门用来指向宿主机的内置域名
  • Linux环境：可以用宿主机的局域网IP（比如192.168.1.100），部分新版本Docker也支持host.docker.internal，如果不支持就直接用宿主机IP
• 检查MySQL的绑定配置
  • 打开MySQL的配置文件（my.cnf或my.ini），找到bind-address配置项，将其修改为0.0.0.0（允许所有IP访问），默认可能只绑定了127.0.0.1，导致容器无法访问
  • 修改后重启MySQL服务生效
• 验证MySQL用户访问权限
  • 确保你使用的数据库账号（比如root）允许从容器所在的IP段访问，执行以下SQL命令：

    GRANT ALL ON myDb.* TO 'root'@'%' IDENTIFIED BY '1234';
    FLUSH PRIVILEGES;
    

    （注意：生产环境不要用%，限制为容器的具体IP或IP段更安全）
• 测试容器到宿主机的网络连通性
  • 进入容器内部，执行telnet 宿主机IP 3306，如果能连通说明网络没问题；如果不通，检查宿主机防火墙是否开放了3306端口，或者Docker的网络配置是否有问题
• 临时测试用host网络模式
  • 启动容器时添加--network host参数，让容器直接使用宿主机的网络栈，此时连接字符串用127.0.0.1就能访问，但这种模式不推荐用于生产环境，仅用于快速排查问题

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