Linux服务器Gmail IMAP连接报错：无法创建TCP套接字（地址族不被支持）

嘿，这个错误我之前帮不少开发者排查过，大概率是IPv6支持或者代码里的地址族配置出了问题，给你整理几个常见的解决方向：

1. 服务器IPv6被禁用了 #

Gmail的IMAP服务器（imap.gmail.com）同时支持IPv4和IPv6，但如果你的Linux服务器禁用了IPv6，而你的IMAP客户端默认优先尝试IPv6连接，就会触发这个错误。

• 快速检查：在终端跑这个命令看看IPv6状态：

  cat /proc/sys/net/ipv6/conf/all/disable_ipv6
  

  如果返回1，说明IPv6确实被禁用了。
• 解决办法：
  • 临时启用：用root权限执行这条命令，然后重启你的应用试试：

    echo 0 > /proc/sys/net/ipv6/conf/all/disable_ipv6
    

  • 永久启用：编辑/etc/sysctl.conf，添加或修改这一行：

    net.ipv6.conf.all.disable_ipv6 = 0
    

    然后执行sysctl -p让配置生效。
  • 不想开IPv6？那就在代码里强制用IPv4连接，具体看下面的代码调整部分。

2. 代码里硬指定了不支持的地址族 #

如果你的代码里硬编码了使用IPv6（比如加了/ipv6参数），但服务器不支持，肯定会报错。举几个常见语言的调整例子：

PHP的IMAP扩展： #

如果你的代码是这样的：

imap_open('{imap.gmail.com:993/imap/ssl/ipv6}INBOX', $email, $password);

把/ipv6去掉，改成让客户端自动适配支持的地址族：

imap_open('{imap.gmail.com:993/imap/ssl}INBOX', $email, $password);

Python的imaplib： #

可以强制解析imap.gmail.com的IPv4地址，再用这个地址连接：

import socket
import imaplib

# 只解析IPv4地址
addr_info = socket.getaddrinfo('imap.gmail.com', 993, socket.AF_INET)
imap_host = addr_info[0][4][0]

# 用IPv4地址建立SSL连接
imap = imaplib.IMAP4_SSL(imap_host, 993)
imap.login('your_email@gmail.com', 'your_app_password')

3. DNS解析或网络配置有问题 #

有时候DNS解析返回的只有IPv6地址，而服务器不支持，也会出这个错。你可以先跑一下这个命令看看解析结果：

nslookup imap.gmail.com

如果只返回IPv6地址，那得检查你的/etc/resolv.conf是不是配置了正确的DNS服务器（比如用8.8.8.8这类公共DNS试试）。

4. 防火墙/SELinux的小概率影响 #

虽然这个错误主要和地址族有关，但也可以快速排查下：

• 检查防火墙是否允许 outbound 的993端口（IMAPS）：iptables -L -n | grep 993
• 临时关闭SELinux试试：setenforce 0，如果能正常连接了，再去配置SELinux的相关规则。

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