Go path.Match 怎样匹配带通配符的资源名

在配置文件、对象存储键或 URL 资源名中筛选一组固定格式的名称时，Go 的 path.Match 可以直接完成通配符匹配。先记住三个边界：它要求模式匹配完整字符串，* 和 ? 不会跨过正斜杠，而且合法但不匹配与模式语法错误是两回事。

先固定资源名的匹配边界

path.Match(pattern, name) 返回 (bool, error)。例如 assets/*.json 能匹配 assets/user.json，但不能匹配 assets/archive/user.json，因为星号只覆盖当前段，不能越过 /。同样，file?.txt 只接受一个字符的位置，file12.txt 不会被它命中。

最小写法可以把资源过滤放在一个明确的函数里，避免在业务代码中散落字符串判断：

package main

import (
    "fmt"
    "path"
)

func allowResource(pattern, resource string) (bool, error) {
    // 先返回模式错误，避免把配置写错误判成资源不存在。
    matched, err := path.Match(pattern, resource)
    if err != nil {
        return false, fmt.Errorf("invalid resource pattern %q: %w", pattern, err)
    }
    // matched 只表示完整字符串是否命中，不会做路径清洗或递归遍历。
    return matched, nil
}

func main() {
    ok, err := allowResource("assets/*.json", "assets/user.json")
    fmt.Println(ok, err)
}

这里的 path 面向正斜杠分隔的路径，例如 URL 或对象键。如果输入来自 Windows 本地文件系统，分隔符和转义语义不同，应改看 path/filepath.Match 的规则，不要只把反斜杠替换成斜杠后假设两者完全等价。

用字符类与转义处理特殊名称

除了两个通配符，模式还支持非空字符类：[abc] 匹配其中一个字符，[0-9] 表示范围，[^0-9] 表示排除范围。需要把 * 当作普通文件名字符时，在非 Windows 语义下可使用反斜杠转义，例如 literal\*。

字符类没有闭合、范围写法非法、单独出现反斜杠时，返回的是 path.ErrBadPattern。生产配置可以在加载阶段集中检查：

package main

import (
    "errors"
    "fmt"
    "path"
)

func checkPattern(pattern string) error {
    // 空名称只用于触发语法解析，不代表业务资源。
    _, err := path.Match(pattern, "")
    if err == nil {
        return nil
    }
    if errors.Is(err, path.ErrBadPattern) {
        return fmt.Errorf("resource filter %q has invalid syntax: %w", pattern, err)
    }
    // 保留未来实现可能增加的其他错误，便于审计和定位。
    return err
}

检查通过后，运行时仍要把“合法但不匹配”当成正常分支处理。不要用 strings.Contains 代替它：那样既无法表达字符类，也会把部分匹配误当作完整资源名匹配。

发布前的四项检查

1. 确认输入是 URL、对象键等正斜杠资源名；本机路径改用 filepath.Match。
2. 把 *、? 和字符类写成能说明业务范围的最小模式，不用一个宽泛的 * 接收所有资源。
3. 启动或加载配置时先验证模式，记录具体 pattern；请求处理阶段只记录命中与否，避免把用户资源原文写入敏感日志。
4. 为嵌套目录、空段、特殊字符和错误模式补上单元测试，尤其确认模式必须匹配完整 name。

常见问题

path.Match 能像正则表达式一样使用 ** 吗？

不能按常见 glob 的“跨多级目录”直觉使用。这里的星号仍受分隔符边界约束；需要递归枚举文件时，应把匹配和遍历分别设计。

为什么返回 false 却没有 error？

这通常表示模式语法合法，但完整的 pattern 没有匹配 name。只有模式本身格式错误时才应按 ErrBadPattern 处理。

什么时候改用 path/filepath.Match？

当输入是操作系统本地文件路径时使用它，并按目标系统的分隔符与转义规则写测试；path.Match 更适合 URL、对象键等正斜杠文本。

把“资源名语义”“模式语法”和“配置错误”分开，path.Match 就能成为一个清晰的过滤边界，而不是藏在业务条件里的模糊字符串判断。