Go文件权限控制需解耦“能做什么”与“谁允许做”：定义带user参数的存储接口（如ReadFile、WriteFile），用SecureFS代理模式封装权限校验，强制路径标准化与层级策略匹配，并通过可替换Authorizer接口保障测试与生产一致性。
Go 里做文件权限控制，不能靠 os.Chmod 或 fs.FileMode 硬编码校验——那等于把权限逻辑散落在各处，改个策略就得翻十几处代码。真正可行的路径，是用接口把「能做什么」和「谁允许做」彻底解耦。
定义带权限语义的存储接口
别直接扩展现有 afero.Fs 或 io/fs.FS，它们不承载权限意图。应该定义新接口，方法名显式体现访问控制边界：
-
ReadFile(ctx context.Context, path string, user User) ([]byte, error)——user是调用方身份，不是可选参数 -
WriteFile(ctx context.Context, path string, data []byte, perm fs.FileMode, user User) error—— 写入前必须校验user是否有写权 -
Delete(ctx context.Context, path string, user User) error—— 删除操作单独授权，不复用写权限
关键点：所有方法都强制传入 user，避免漏校验；错误类型统一返回自定义 ErrPermissionDenied，而不是暴露底层 os.ErrPermission 或 S3 的 AccessDenied。
用代理模式包装真实存储实现
权限校验逻辑不能侵入业务代码，也不该塞进存储实现里。标准做法是让 SecureFS 实现同一套接口，内部持有真实 afero.Fs 和权限检查器：
立即学习“go语言免费学习笔记（深入）”；
-
SecureFS构造时注入Authorizer接口（比如func(user User, op Op, path string) bool） - 每次
WriteFile调用前，先跑authorizer(user, WriteOp, path)，返回false就直接return ErrPermissionDenied - 真实读写仍委托给底层
afero.Fs，不重复实现 IO
常见错误：在 SecureFS.WriteFile 里手动调 os.Stat 判断路径是否存在——这绕过了代理层，也破坏了抽象。所有路径检查必须走同一入口，否则权限逻辑就断了。
路径权限策略要支持层级继承
真实系统中权限不是扁平的，/uploads/ 允许用户上传，但 /uploads/admin/ 必须 admin 才能写。策略引擎得支持路径前缀匹配：
- 用
trie或有序切片维护规则表：[/uploads/* → user:read,write]、[/uploads/admin/* → admin:read,write,delete] - 匹配时取最长前缀，避免
/uploads覆盖/uploads/admin - 注意路径标准化：传入
"uploads\admin\file.txt"（Windows）或"uploads//admin/file.txt"（双重分隔符）必须先filepath.Clean再匹配，否则策略失效
容易被忽略的是：策略规则本身也要可测试。别把匹配逻辑写死在 SecureFS 里，抽成独立函数 MatchPolicy(path string, rules []PolicyRule) *PolicyRule，单元测试才能覆盖边界 case。
测试时权限校验必须可替换
单元测试不能依赖真实权限服务（如 LDAP、RBAC API）。正确姿势是把 Authorizer 也做成接口，并在测试中用闭包快速构造 mock：
- 测试 guest 用户无法删除：
mockAuth := func(u User, op Op, p string) bool { return u.Role == "admin" && op == DeleteOp } - 初始化
SecureFS时传入该闭包，而非真实实现 - 集成测试才连真实授权后端，且必须限定在
integrationbuild tag 下，避免拖慢常规 CI
最常踩的坑是：测试用了 mock Authorizer，但生产环境初始化时忘了传，导致 SecureFS 内部 authorizer 为 nil，panic 在运行时才暴露。务必在 SecureFS 构造函数里加 if authorizer == nil { panic("authorizer is required") }。
权限抽象最难的部分从来不是代码怎么写，而是策略变更时如何保证所有路径匹配逻辑、所有方法入口、所有测试用例同步更新——接口只是容器，真正的复杂度藏在策略模型和它的演化约束里。
