Django项目启动出现django-main-thread线程UnicodeDecodeError报错求助

这问题我之前折腾过好一会儿！从报错栈能看出来，核心问题是系统主机名包含了无法用UTF-8解码的字符，导致Django启动过程中调用socket.getfqdn()解析主机名时触发了编码异常。下面给你几个实用的解决办法：

方法1：临时指定IP启动服务器（最快生效） #

直接绕开主机名解析步骤，启动时明确指定本地IP和端口：

python manage.py runserver 127.0.0.1:8000

这样Django会直接绑定到指定IP，不会去调用getfqdn()，立刻就能启动项目。

方法2：修改系统主机名（彻底解决） #

如果想从根源解决，把系统主机名改成纯ASCII字符（英文+数字）：

• Windows系统：右键「此电脑」→「属性」→「更改设置」→「更改」，修改计算机名为全英文/数字组合，重启系统后再启动项目。
• Linux/macOS系统：编辑/etc/hostname文件修改主机名，执行hostnamectl set-hostname 新主机名（Linux）或通过系统偏好设置修改（macOS），重启后生效。

方法3：给socket模块打补丁（无需改系统设置） #

如果暂时不想改主机名，可以在项目的manage.py最顶部添加一段补丁代码，覆盖socket.getfqdn()的默认行为：

import socket
# 备份原始的getfqdn方法
original_getfqdn = socket.getfqdn

def patched_getfqdn(name=''):
    try:
        return original_getfqdn(name)
    except UnicodeDecodeError:
        # 解码失败时返回localhost，避免崩溃
        return 'localhost'

# 替换成补丁方法
socket.getfqdn = patched_getfqdn

# 下面是原来的manage.py代码
...

这个补丁会在getfqdn()抛出编码错误时返回localhost，让Django正常启动。

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