Next.js 13中next/headers获取host返回[::1]:xxxx异常值的原因

1. [::1]的来源 #

[::1]是IPv6协议中的本地回环地址，功能和IPv4的127.0.0.1完全一致，都是指向本机。当这位开发者的系统网络配置中，IPv6的解析优先级高于IPv4时，localhost会被解析为[::1]，进而导致headers().get("host")返回这个IPv6地址，而非你这边的localhost。

2. 随机端口的来源 #

Next.js开发服务器默认会尝试使用3000端口启动。如果该端口被其他进程占用，服务器会自动扫描并选择一个未被占用的随机端口（比如你看到的59982）。如果每次启动都出现随机端口，大概率是以下情况之一：

• 3000端口长期被其他程序占用，开发者未清理占用进程
• 启动项目时没有明确指定固定端口（比如未使用npm run dev -p 3000这类命令，或项目配置文件里没固定端口）

验证建议 #

• 让开发者在终端执行ping localhost，看返回的是IPv4地址还是IPv6地址，确认解析优先级
• 检查3000端口占用情况：Mac/Linux用lsof -i :3000，Windows用netstat -ano | findstr :3000
• 启动项目时明确指定端口，比如npm run dev -- -p 3000

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