Go net/url.URL 怎样保留错误信息

用Go做HTTP请求、路由校验、参数处理的场景里，经常要用到标准库`net/url`包的URL结构体做解析处理，不少开发者都遇到过解析出错后返回的错误信息太笼统，连原本输入的异常URL内容都找不到的问题，很不利于线上问题排查。

你可以自定义一个封装类型，把原始输入的URL字符串、net/url返回的底层错误信息同时绑定存储，后续抛出错误、打印日志的时候就可以拿到全部上下文，不会丢失关键的错误细节。

Go 的 net/url.URL 本身是解析后的数据结构，错误信息来自 url.Parse 或 (*URL).Parse 返回的第二个值。要保留完整线索，关键是保留这个 error，再用 errors.As 取出 *url.Error；不要只记录 err.Error() 后重新创建一个普通错误。

先让 Parse 的错误留在返回链里

解析入口应同时接收 URL 对象和错误。失败时，URL 指针可能为空，真正可定位的信息在错误链里。下面的包装方式会保留底层错误，调用方仍可以继续判断具体类型。

package main

import (
    "errors"
    "fmt"
    "net/url"
)

func parseEndpoint(raw string) (*url.URL, error) {
    u, err := url.Parse(raw)
    if err != nil {
        // 用 %w 保留 url.Error 及其底层原因，便于上层继续分类。
        return nil, fmt.Errorf("解析 endpoint 失败: %w", err)
    }
    return u, nil
}

func diagnose(raw string) error {
    _, err := parseEndpoint(raw)
    if err == nil {
        return nil
    }

    var urlErr *url.Error
    if errors.As(err, &urlErr) {
        // urlErr.URL 是输入，urlErr.Err 是真正的底层原因。
        fmt.Printf("op=%s url=%q cause=%v\\n", urlErr.Op, urlErr.URL, urlErr.Err)
    }
    return err
}

这里的重点不是把 url.Error 的文本复制出来，而是让它继续存在于错误链中。日志可以单独打印 Op、URL 和 Err，返回值仍交给上层处理。

用 errors.As 读取 url.Error 的三段信息

官方类型 url.Error 记录了 Op、URL 和 Err，并实现了 Unwrap。因此上层即使加了一层“配置读取失败”这样的上下文，也不需要依赖字符串匹配。

如果只想判断错误类别，优先使用 errors.As 或 errors.Is。例如底层是 url.EscapeError 时，可继续提取它，而不是判断错误文本里是否出现某个片段。

var escapeErr url.EscapeError
if errors.As(err, &escapeErr) {
    // EscapeError 表示 URL 中的百分号转义序列不合法。
    fmt.Printf("bad escape=%q\\n", string(escapeErr))
}

URL 字段与错误信息不要混为一谈

解析成功后，URL 的字段只描述结果：Path 是解码后的路径语义，RawPath 在需要保留非默认转义时提供提示，RawQuery 保存编码后的查询部分。String() 会根据这些字段重新组装 URL，但不会把过去的解析错误附加进去。

因此，业务代码应把“解析阶段的 error”和“成功后的 URL 对象”分开保存。若需要在日志里复现问题，记录原始输入与错误链；若需要发送请求，再使用成功返回的 URL 对象或它的 String() 结果。

常见问题

为什么不建议直接保存 err.Error()

字符串适合展示，不适合分类。保存原始 error 才能用 errors.As 识别 *url.Error 或底层 EscapeError。

业务上下文会不会覆盖 url.Error

使用 fmt.Errorf("...: %w", err) 不会覆盖，它只是增加一层包装；使用 %v 或重新拼接字符串才会切断可识别的错误链。

Parse 成功后还能读取解析错误吗

不能。成功返回的 URL 只代表结构已生成；需要诊断失败输入时，应在返回错误的分支立即记录或向上返回。