Azure中MySQL启用IPv6及OpenZipkin连接异常问题咨询

针对你遇到的OpenZipkin（Docker部署）突然无法连接Azure MySQL的问题，结合Azure MySQL的网络特性，我整理了以下排查和解决思路：

一、先明确Azure MySQL的IPv6支持限制 #

首先得区分你的MySQL实例类型，这直接决定了IPv6的可行性：

• Azure MySQL Single Server：目前完全不支持IPv6连接，防火墙规则也仅允许添加IPv4地址——这是服务的固有限制，近期官方没有调整这个规则，所以突然报错大概率不是Azure端的IPv6配置变更导致的，更可能是Docker容器侧的网络行为变化（比如镜像更新后默认启用了IPv6）。
• Azure MySQL Flexible Server：支持IPv6，但有前提：
  • 必须在实例创建时配置IPv6（创建后无法修改）；
  • 若选择虚拟网络集成，需要确保虚拟网络已配置IPv6地址空间；
  • 若选择公共访问，仅部分区域支持添加IPv6防火墙规则。

二、排查OpenZipkin容器的网络问题 #

既然代码和Docker标签都没改，优先检查容器的网络行为：

• 强制容器禁用IPv6：启动容器时添加参数--sysctl net.ipv6.conf.all.disable_ipv6=1，这样容器会默认使用IPv4连接MySQL，避免因IPv6解析失败报错。
• 强制指定MySQL的IPv4地址：在OpenZipkin的配置中，直接使用MySQL实例的IPv4地址而非域名，跳过DNS解析环节（如果你的MySQL域名被解析出IPv6记录的话）。
• 查看容器日志：提取具体的连接错误信息（比如Could not connect to IPv6 address xxx），确认是否是IPv6连接尝试导致的问题。

三、若需启用Azure MySQL的IPv6连接（仅Flexible Server） #

如果你的实例是Flexible Server且未配置IPv6，只能通过重新创建实例来启用：

1. 在创建Flexible Server的「网络」配置步骤：
   • 选择「虚拟网络集成」，关联一个已配置IPv6地址空间的虚拟网络；
   • 或选择「公共访问」，在「允许的IPv6地址」中添加需要访问的IPv6范围（注意先确认你的Azure区域支持该特性）。
2. 实例创建完成后，在防火墙规则中添加对应的IPv6地址/范围，同时确保你的OpenZipkin容器所在网络能访问该IPv6地址。

四、临时应急方案 #

如果暂时无法调整MySQL实例，可通过以下方式强制IPv4连接：

• 在Docker启动命令中添加--dns-ipv6=false，禁用容器的IPv6 DNS解析；
• 在容器内的/etc/hosts文件中添加MySQL域名与IPv4地址的映射，强制解析到IPv4。

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