Python3.6+中Flask无法启动，socket.gethostbyaddr解析localhost报错

先给你理清楚问题本质：你遇到的这个UnicodeDecodeError，核心是Python 3对字符串编码的校验比Python 2严格得多。从你给出的测试结果能看到：

• Python 2里socket.gethostbyaddr('127.0.0.1')返回了一个带\x96字节的奇怪主机名xn\x969q8h，Python 2用字节串处理，不做强制解码，所以没报错；
• 但Python 3会自动尝试把这个主机名字节串用UTF-8解码，而0x96根本不是合法的UTF-8起始字节，直接触发了解码失败；
• 最终这个错误在Flask启动时调用socket.getfqdn(host)（内部会调用gethostbyaddr）时爆发，导致服务启动失败。

而且这个奇怪的主机名肯定和你最近装Docker有关——系统hostname返回正常的DESKTOP-XXXXX，说明系统主机名没问题，是Docker修改了本地DNS/反向解析配置，让127.0.0.1反向解析到了这个非法编码的主机名。

先快速让Flask跑起来（临时方案） #

如果急着启动服务，可以用下面两种方法绕过这个问题：

方法1：修改Flask启动代码 #

把app.run()改成下面这样，直接指定主机并关闭自动重载（重载逻辑会再次触发主机名解析）：

# 仅本地访问
app.run(host='127.0.0.1', use_reloader=False)
# 允许外部设备访问的话用这个
app.run(host='0.0.0.0', use_reloader=False)

方法2：给socket打个临时补丁 #

在Flask启动前加一段代码，强制getfqdn返回正确的主机名：

import socket
original_getfqdn = socket.getfqdn

def patched_getfqdn(name=''):
    # 针对127.0.0.1和localhost直接返回正确主机名
    if name in ('127.0.0.1', 'localhost'):
        return 'DESKTOP-XXXXX'  # 这里替换成你cmd里hostname返回的结果
    return original_getfqdn(name)

# 替换原函数
socket.getfqdn = patched_getfqdn

# 然后正常启动Flask
app.run()

彻底解决问题（修复反向解析配置） #

要根治这个问题，得把本地的反向解析配置改回来：

• 检查hosts文件：
  打开C:\Windows\System32\drivers\etc\hosts（Windows），确认127.0.0.1对应的是localhost或者你的正常主机名DESKTOP-XXXXX，删掉任何奇怪的解析记录。

• 重置Docker网络配置：
  既然是装完Docker出的问题，试试重置Docker网络：

  • Windows：打开Docker Desktop → 设置 → 网络 → 点击「重置为默认值」；
  • Linux/macOS：终端执行docker network prune清理无用网络，然后重启Docker。

• 刷新DNS缓存：

  • Windows：CMD里执行ipconfig /flushdns；
  • Linux：执行systemd-resolve --flush-caches（不同发行版可能有差异，比如Ubuntu用这个）；
  • macOS：终端执行dscacheutil -flushcache。

• 切换DNS服务器：
  如果你用了自定义DNS，试试换成公共DNS（比如8.8.8.8），看反向解析是否恢复正常。

验证修复是否生效 #

修复后，打开Python 3终端执行下面的命令，如果不报错且返回正常主机名，就说明问题解决了：

import socket
socket.gethostbyaddr('127.0.0.1')

正常结果应该是类似('DESKTOP-XXXXX', [], ['127.0.0.1'])这样的。

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