Predicate 是返回布尔值的无副作用函数，用于中间件中安全、可组合、隔离的请求准入控制，支持可观测、可降级与环境可控的白名单校验链。

理解 Predicate 在中间件中的核心作用

Predicate（谓词）本质上是一个返回布尔值的函数，它不执行副作用，只做“判断”。在中间件开发中，它天然适合做请求准入控制——比如判断某个请求是否来自白名单域名、IP 或用户身份。关键在于：Predicate 本身不修改任何状态，也不触发业务逻辑，这为“安全隔离”提供了基础保障。

用 Predicate 构建可组合的白名单校验链

避免把所有白名单规则硬编码在一个 if 判断里。应将每条规则拆成独立、可测试的 Predicate：

• domainInWhitelist：解析 Host 头，比对预置域名列表（支持通配符如 *.example.com）
• ipInRange：将 X-Forwarded-For 首地址转为 IPv4/IPv6，检查是否落在 CIDR 段内
• headerTokenValid：验证自定义白名单 Token（非认证 Token，仅用于内部服务标识）

再用逻辑组合子（如 and()、or()）按需拼装，例如：
allowIf(and(domainInWhitelist, ipInRange)) —— 只有域名和 IP 同时合规才放行。

隔离全局环境：Predicate 必须无状态、无依赖

所谓“安全隔离”，首要防止 Predicate 意外读取或污染运行时上下文。做到这点的关键是：

• 所有白名单数据（如域名列表、CIDR 规则）在中间件初始化时加载为不可变结构（如 Set、ImmutableList），不从 process.env 或配置中心实时读取
• Predicate 函数参数仅限当前请求对象（如 req）或其明确提取的字段（req.hostname、req.ip），绝不访问 global、require.cache 或其他模块私有变量
• 禁止在 Predicate 内部调用异步操作（如数据库查询、HTTP 请求）——若需动态白名单，应提前同步拉取并缓存，Predicate 仍保持同步纯函数

实战建议：让 Predicate 可观测、可降级、可绕过

生产环境中，Predicate 不仅要正确，还要可控：

• 每条 Predicate 执行前后打结构化日志，记录匹配结果、耗时、触发的规则名，便于审计和问题回溯
• 提供运行时开关（如通过 Redis Flag 或本地原子布尔量），允许紧急关闭某条 Predicate 而不影响整个中间件流程
• 在开发/测试环境，支持通过请求头（如 X-Bypass-Whitelist: true）临时跳过校验——但该头必须在 Predicate 外层统一识别，且仅当环境变量 NODE_ENV !== 'production' 时生效