Golang HTTP GET 请求返回 404 错误排查与解决

碧海醫心

发布时间：2025-10-07 11:21:41

311人浏览过

来源于php中文网

原创

golang http get 请求返回 404 错误排查与解决

本文旨在帮助开发者解决在使用 Golang 的 net/http 包发送 HTTP GET 请求时，遇到返回 404 Not Found 错误的问题。通过分析问题原因，并提供相应的解决方案，帮助开发者避免类似错误，确保 HTTP 请求的正确执行。主要聚焦于 URL 编码处理，特别是当 URL 中包含特殊字符时，Golang 的默认处理方式与 cURL 等工具的差异，以及如何通过调整编码或使用 Opaque URL 来解决问题。

在使用 Golang 的 net/http 包发送 HTTP GET 请求时，开发者有时会遇到返回 404 Not Found 错误，即使同样的 URL 在 cURL 等工具中可以正常访问。这通常是由于 Golang 的 HTTP 客户端对 URL 中的特殊字符进行了自动解码，导致服务器无法正确识别请求路径。

问题分析

Golang 的 net/http 包在创建新的 HTTP 请求时，会对 URL 进行一定的处理，包括将 URL 编码的字符解码为原始字符。例如，%2F 会被解码为 /，%3D 会被解码为 =。虽然这种自动解码在很多情况下是方便的，但在某些情况下，服务器可能期望接收到原始的 URL 编码字符，而不是解码后的字符。

立即学习“go语言免费学习笔记（深入）”；

解决方案

针对上述问题，可以采用以下两种解决方案：

修改 URL 编码

如果 URL 中包含的特殊字符需要保持 URL 编码状态，则需要对这些字符进行双重编码。例如，如果 URL 中需要包含 %2F，则需要将其替换为 %252F。这样，Golang 的 HTTP 客户端在解码时，会将 %252F 解码为 %2F，从而保证服务器接收到正确的 URL 编码字符。

魔术橡皮擦
智能擦除、填补背景内容

下载

使用 Opaque URL

net/url 包中的 URL 结构体提供了一个 Opaque 字段，用于存储不透明的 URL 字符串。当使用 Opaque URL 时，Golang 的 HTTP 客户端不会对 URL 进行任何解码操作，而是直接将 Opaque 字段的值作为请求的 URL。

以下是使用 Opaque URL 的示例代码：

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

func main() {
    urlString := "http://example.com/path%2Fwith%2Fencoded%2Fslashes"

    u, err := url.Parse(urlString)
    if err != nil {
        fmt.Println("Error parsing URL:", err)
        return
    }

    // 使用 Opaque URL 绕过自动解码
    u.Opaque = u.Path
    u.Path = ""

    req := &http.Request{
        Method: "GET",
        URL:    u,
        Proto:  "HTTP/1.0",
        ProtoMajor: 1,
        ProtoMinor: 0,
        Header: make(http.Header),
    }

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error sending request:", err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("Error reading response body:", err)
        return
    }

    fmt.Println("Response Status:", resp.Status)
    fmt.Println("Response Body:", string(body))
}

代码解释：