unique.Handle 如何为路由方法与路径组合去重

做路由加载器时，我更愿意先把“方法 + 路径”收敛成一个值，再让 unique.Make 负责身份复用。关键点不是给字符串换一种写法，而是让 GET /users 和来自另一份配置的同语义组合先经过同一套规范化，然后生成可直接比较的 Handle[RouteKey]。重复路由只需比较句柄；但注册表本身仍要用锁保护，unique 不会替你完成业务层的并发写入。

一、先把方法与路径收敛为可比较的 RouteKey

路由去重最容易踩的坑是把原始输入直接当作事实。下面的结构只有两个字符串字段，满足 comparable；normalizePath 只演示一个明确边界：去掉末尾斜杠，但保留根路径。生产项目还应按照自己的路由器规则处理连续斜杠、转义字符和参数占位符。

package main

import (
	"fmt"
	"strings"
)

// RouteKey 把路由的两个身份维度放在一个可比较值中。
type RouteKey struct {
	Method string
	Path   string
}

// normalizePath 只处理尾斜杠，避免把业务路由规则藏进 unique 包。
func normalizePath(path string) string {
	path = strings.TrimSpace(path)
	if path == "/" {
		return path
	}
	return strings.TrimRight(path, "/")
}

// canonicalKey 在生成 Handle 前统一方法和路径的表示。
func canonicalKey(method, path string) RouteKey {
	return RouteKey{
		Method: strings.ToUpper(strings.TrimSpace(method)),
		Path:   normalizePath(path),
	}
}

func main() {
	key := canonicalKey(" get ", "/users/")
	fmt.Printf("%s %s\\n", key.Method, key.Path)
}

这里的顺序很重要：如果一份配置保留 GET /users/，另一份配置变成 get /users，只有统一后才会得到同一个 RouteKey。unique.Make 只比较它收到的值，不负责猜测“这些字符串是否语义相同”。

二、用 unique.Make 生成路由句柄

Go 1.23 引入的 unique 包提供了泛型函数 Make[T comparable]。它返回 Handle[T]：当两个输入值相等时，两个句柄相等；句柄的比较通常比反复比较完整值更轻量。路由注册器可以把句柄作为去重索引，同时把原始配置保留在另一张表里。

import "unique"

// routeHandle 把规范化后的 RouteKey 变成稳定的进程内身份。
func routeHandle(method, path string) unique.Handle[RouteKey] {
	key := canonicalKey(method, path)
	return unique.Make(key)
}

// sameRoute 展示句柄相等代表输入 RouteKey 相等。
func sameRoute() bool {
	left := routeHandle("GET", "/users/")
	right := routeHandle(" get ", "/users")
	return left == right
}

Handle 的身份是进程内的运行时概念，不应序列化为跨进程协议字段，也不要把它当作可读路由名。需要日志或配置回写时，调用 Value() 取回产生句柄的值；官方文档定义它返回的是 浅拷贝，并且可并发调用。

三、在并发注册中按句柄去重

句柄相等不能替代 map 的并发保护。多个 goroutine 如果同时执行“查找不存在—插入”，即使它们拿到的是同一个句柄，也可能在业务记录层重复写入。把检查和插入放进同一个互斥锁临界区，返回值就能明确表示这次注册是否真正新增。

type Registry struct {
	mu      sync.Mutex
	entries map[unique.Handle[RouteKey]]string
}

// Register 以句柄为索引，锁住查找和插入这两个必须连续的动作。
func (r *Registry) Register(method, path, handler string) bool {
	h := routeHandle(method, path)
	r.mu.Lock()
	defer r.mu.Unlock() // 无论新增还是重复，都确保解锁。
	if _, exists := r.entries[h]; exists {
		return false
	}
	r.entries[h] = handler
	return true
}

示例省略了构造函数和导入列表，重点是临界区边界：routeHandle 可以在锁外计算，map 的判断与写入不能拆开。若还需要按路径生成路由树，句柄只是去重索引，树结构仍由路由器负责。

四、检查 Value 与适用边界

如果只是一个很小的注册表，直接使用规范化后的 RouteKey 作为 map 键也足够清晰；引入 unique.Handle 的收益在于让共享身份可以被多个组件引用，并减少重复值比较。选择它前，先确认你的问题确实是“值的规范化身份”，而不是需要排序、模糊匹配或跨进程稳定哈希。

相关问题

RouteKey 中能放 []string 吗？

不能直接放，因为切片不是 comparable。可先把参数整理成字符串或不可变数组形式，但要先定义清楚序列化规则。

unique.Make 会自动忽略路径尾斜杠吗？

不会。Make 只根据传入值建立句柄，尾斜杠、大小写和转义处理必须由你的规范化函数完成。

Handle 可以写进 Redis 或数据库吗？

不建议。它表达的是当前 Go 进程里的身份；跨进程数据应保存方法、路径等业务字段，或保存明确约定的稳定键。