为何Aspire MySQL服务无法被发现？ASP.NET Core连接失败排查

问题核心 #

使用Aspire集成开发工作流时，ASP.NET Core应用通过服务名db连接MySQL容器失败，提示Unable to connect to any of the specified MySQL hosts，但改用localhost:3306可以正常连接。

解决步骤 #

1. 移除MySQL服务的显式端口映射配置
   当前MySQL配置中添加的.WithEndpoint(port: 3306, targetPort: 3306, name: "mySqlPort")会将容器端口绑定到主机端口，干扰Aspire内部服务网格的DNS解析逻辑。移除该配置后，Aspire会自动管理服务间的内部网络通信。

   修改后的MySQL配置代码：

   var mysql = builder.AddMySql("db")
       .WithLifetime(ContainerLifetime.Persistent)
       .WithInitBindMount("../sql/", true)
       .WithDataVolume();
   

2. 保持连接字符串的服务名配置
   确保连接字符串仍使用服务名db，无需额外指定端口（或明确写3306，与MySQL容器内部默认端口一致）：

   builder.AddProject<Projects.GraphQL>("graphql")
       .WaitFor(mysql)
       .WithEnvironment("ConnectionStrings__FooContext",
           "Server=db;Database=Foo;User=root;Password=aVerysecretPasswordIndeed;");
   

原因说明 #

• Aspire的服务网格会为每个容器服务创建内部DNS记录，服务名db可直接解析到MySQL容器的内部IP，服务间通过内部网络通信，无需暴露端口到主机。
• 显式绑定主机端口后，应用可能误将db解析为主机IP，尝试访问主机的3306端口，内部服务网格的DNS解析逻辑被干扰，导致连接失败。
• 使用localhost能连接是因为直接访问了主机上绑定的容器端口，绕过了Aspire的内部服务发现机制。

验证操作 #

• 重启Aspire AppHost，确认MySQL容器启动时未绑定主机3306端口。
• 查看Aspire Dashboard的服务拓扑，确认db与graphql服务处于同一内部网络。
• 调试确认ServerVersion.AutoDetect使用的连接字符串确实是Server=db;...，未被其他配置覆盖。

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