recover 不应用于 IP 段解析匹配过程,因 net.ParseCIDR 和 net.IPNet.Contains 不会 panic,仅返回 error 或 bool;容错应通过显式错误检查实现,而非 recover 掩盖本该在预加载阶段暴露的非法 CIDR 配置。

recover 不该用在 IP 地址段解析匹配过程中做容错。
标准库 net.ParseCIDR 和 net.IPNet.Contains 是纯内存计算、无副作用、不 panic 的函数。它们只返回 error 或布尔值,不会触发 panic。你试图用 recover 捕获的“异常”,根本不存在。
为什么有人想用 recover?常见误解来源
- 把字符串解析(如
net.ParseCIDR("192.168.1.0/xx"))误当成可能 panic 的操作 - 看到错误日志里有 panic,误以为是 net 包抛出的,实际是上层代码(比如未检查
err就直接解引用nil *net.IPNet) - 混淆了「输入非法」和「运行时崩溃」:前者返回
error,后者才需要recover
正确做法:用 error 判断,而非 recover
IP 段匹配的容错必须基于显式错误处理:
-
net.ParseCIDR输入非法时返回非 nilerror,必须检查 -
net.ParseIP输入非法时返回nil,不能直接传给Contains - 所有规则预加载阶段就应拒绝非法 CIDR,避免运行时遇到
nil值
func ParseRules(rules []string) ([]*net.IPNet, error) {
var nets []*net.IPNet
for _, r := range rules {
if r == "" {
return nil, fmt.Errorf("empty rule")
}
_, ipnet, err := net.ParseCIDR(r)
if err != nil {
return nil, fmt.Errorf("invalid CIDR %q: %w", r, err)
}
nets = append(nets, ipnet)
}
return nets, nil
}运行时匹配只需遍历调用 ipnet.Contains(ip) —— 它接收 nil ip 会返回 false,不 panic。
文件删除恢复功能 v0.8.0:删除前自动备份文件(存至 `delete_backup/YYYYMMDDHHMM/` 目录),支持从备份中恢复、通过清单(manifest)搜索。具备 SHA256 完整性校验、路径遍历防护及工作区根目录(workspace-root)访问限制。支持自动清理 7 天 / 30 天前的备份。 **v0.8.0:新增 `workspace_cleaner` —— 支持定时清理临时文件,并在删除前自动执行备份。** **v0.7.0:`allowed_roots` 默认值
立即学习“go语言免费学习笔记(深入)”;
如果硬要用 recover,反而埋雷
- 在匹配循环里加
defer func(){ recover() }(),会掩盖真正的 bug(比如空指针、并发写 map) - 掩盖了本该在初始化阶段暴露的配置错误(如把
"10.0.0.0/33"当合法规则加载) - 无法区分是「IP 格式错」还是「规则列表为 nil」还是「某个字段意外为 nil」——所有都变成静默失败
真正需要 recover 的场景,是那些你完全无法控制输入源 + 无法提前校验的极端情况,比如:
- 第三方插件回调中执行用户自定义 Go 表达式(需 sandbox)
- 解析不受信的、结构完全未知的嵌套 YAML/JSON 并动态构造网段规则(此时 panic 可能来自 unmarshal 层)
但这类场景已脱离「IP 段解析匹配」本身,属于更高阶的沙箱或 DSL 执行问题。
别用 recover 给 net 包擦屁股。它不是胶带,是手术刀——只在明确知道谁会切开自己、且必须当场缝合时才拔出来。

















