Go本地localhost服务如何正确获取127.0.0.1格式的客户端IP

• 你拿到的[::1]:55310不是错误结果，::1就是IPv6协议定义的本地回环地址，和IPv4格式的127.0.0.1功能完全等价，都代表本机自身。
• 出现这个现象的核心原因是：你的HTTP服务默认同时监听了IPv4和IPv6栈，本地访问时系统/浏览器优先选择IPv6协议建立连接，r.RemoteAddr（也就是ReadUserIP最终读取的数据源）记录的是TCP连接的对端地址，自然会返回IPv6格式的回环地址。你遍历请求头没有看到IP字段是正常的，直连场景下请求头不会携带客户端IP，只有经过代理转发的请求才会携带X-Forwarded-For这类IP相关头。

根据实际需求选对应方案即可：

• 如果不需要强制IPv4格式：直接在IP判断逻辑里把::1和127.0.0.1都识别为本地回环地址即可，这是兼容性最好的方案，不需要修改服务或客户端配置。
• 如果必须拿到IPv4格式的127.0.0.1，可以选以下任意一种调整方式：
  • 调整服务监听配置：启动HTTP服务时明确绑定IPv4回环地址，不要用默认的空地址监听。比如将原来的http.ListenAndServe(":8080", handler)改为http.ListenAndServe("127.0.0.1:8080", handler)，服务只会绑定IPv4栈，所有本地连接都会走IPv4，读取到的IP自然是127.0.0.1。
  • 调整访问方式：访问服务时不要用localhost域名，直接在地址栏输入http://127.0.0.1:你的服务端口访问，强制客户端走IPv4建立连接。
  • 在IP读取逻辑里加归一化处理：将IPv6回环地址直接转换为IPv4格式返回，参考代码如下：

func normalizeLoopbackIP(remoteAddr string) string {
    host, _, err := net.SplitHostPort(remoteAddr)
    if err != nil {
        host = remoteAddr
    }
    ip := net.ParseIP(host)
    if ip == nil {
        return host
    }
    // 识别IPv6回环地址，统一转换为127.0.0.1
    if ip.IsLoopback() && ip.To4() == nil {
        return "127.0.0.1"
    }
    return host
}

注意：如果你的服务部署在反向代理后面，不要依赖r.RemoteAddr获取用户真实IP，要优先从代理约定的请求头（比如X-Forwarded-For、X-Real-IP）读取，同时要做好头校验防止IP伪造。

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