Go net/url.URL.Port 怎样读取 URL 端口并区分显式与默认值

在批量处理回调地址、代理地址或服务发现结果时，最容易混淆的一点是：URL 没有写端口，并不等于端口已经被 URL.Port() 自动补成了 80 或 443。Go 的 net/url 把“URL 中是否显式出现端口”和“业务最终要连接哪个端口”分成两件事处理。

实际写法是先用 url.Parse 建立错误边界，再用 u.Port() 判断端口是否显式存在；如果返回空字符串，应用层再根据 scheme 选择默认端口。这样既不会误把缺失端口当成异常，也不会把默认值错误地写回原始 URL。

先把 URL 解析和端口读取拆开

URL.Port 返回 Host 中显式端口的文本，而且不包含前面的冒号。比如 https://api.example.com:8443/v1 返回 8443；https://api.example.com/v1 返回空字符串。端口是否缺失，应该由这个返回值判断，而不是用字符串查找冒号。

package main

import (
	"fmt"
	"net/url"
)

func readURLParts(raw string) (string, string, string, error) {
	// 先解析完整 URL；输入不合法时保留错误，避免继续读取半成品字段。
	u, err := url.Parse(raw)
	if err != nil {
		return "", "", "", fmt.Errorf("parse URL: %w", err)
	}

	// Hostname 和 Port 分别读取，避免手工切 Host 时破坏 IPv6 方括号。
	return u.Scheme, u.Hostname(), u.Port(), nil
}

func main() {
	for _, raw := range []string{
		"https://api.example.com:8443/v1",
		"https://api.example.com/v1",
		"http://[2001:db8::10]:8080/health",
	} {
		scheme, host, port, err := readURLParts(raw)
		if err != nil {
			fmt.Println("解析失败:", err)
			continue
		}
		fmt.Printf("scheme=%s host=%s port=%q\\n", scheme, host, port)
	}
}

这里的关键不是把 URL 拆成更多字符串，而是保留 url.Parse 的错误结果。Hostname() 会处理 IPv6 主机的方括号，Port() 只负责显式端口，两者的职责清晰后，后续连接逻辑就不必再猜测原始文本。

空字符串代表“没有显式端口”

批处理程序通常会同时接收带端口和不带端口的地址。此时可以把空字符串作为一个明确分支：有值就使用 URL 中的端口；没有值就交给默认端口策略。不要把 u.Port() == "" 直接当成解析失败，因为一个完全合法的 HTTPS URL 本来就可能不写端口。

func effectivePort(u *url.URL) (string, error) {
	// 端口有值时优先尊重输入，避免覆盖用户显式配置。
	if port := u.Port(); port != "" {
		return port, nil
	}

	// URL.Port 为空只表示没有显式端口，默认值由协议策略决定。
	switch u.Scheme {
	case "http":
		return "80", nil
	case "https":
		return "443", nil
	default:
		return "", fmt.Errorf("unsupported scheme %q without explicit port", u.Scheme)
	}
}

如果业务还支持自定义 scheme，就应该把默认端口表做成显式配置，而不是在这里继续添加猜测。对未知 scheme，返回错误通常比悄悄选择 80 更安全，因为错误能提醒调用方补齐协议配置。

IPv6、非法端口和批量处理时的取舍

IPv6 地址本身包含多个冒号，所以不要用 strings.Split(host, ":") 判断端口。使用 Hostname() 和 Port()，可以把 [2001:db8::10]:8080 解释成主机 2001:db8::10 与端口 8080。这也是把解析责任交给标准库的主要原因。

在批量读取配置时，可以先解析、再计算有效端口，最后才交给连接池或请求客户端。解析错误、未知 scheme 和缺失默认端口要分开记录；不要为了让批次继续而把所有错误地址改写成默认端口。

结论与常见疑问

记住三个边界：url.Parse 负责确认输入能否解析，URL.Port() 只报告显式端口，默认端口必须由应用层根据 scheme 决定。对于 IPv6，始终使用 Hostname() 和 Port() 的组合，避免手工拆分 Host。

URL.Port 返回值为什么不包含冒号？

它返回的是端口部分本身，便于直接交给连接配置或端口转换逻辑；冒号属于 Host 的分隔语法，不属于端口文本。

没有端口时能不能直接返回 443？

只有在已经确认 scheme 是 HTTPS，且业务明确采用 HTTPS 默认端口时才可以。通用解析函数不应对未知 scheme 盲目返回 443。

为什么不直接读取 URL.Host？

Host 同时包含主机名、IPv6 方括号和可选端口，手工切分容易把 IPv6 内部冒号误判成端口分隔符。标准库已经提供了职责更清晰的读取方法。