服务治理组件统一白名单控制一、背景与问题在微服务架构下白名单控制几乎是必需能力接口级访问控制IP / 应用 / 用户灰度、内测、运营活动限制风控与安全兜底临时封禁、应急止血但现实中常见问题是白名单逻辑散落在各个服务、Controller、网关配置方式不统一DB / Redis / Nacos / 配置文件修改不实时需要发版没有审计、没有版本 结论必须抽成一个统一的服务治理组件。二、设计目标目标说明统一入口所有白名单能力一个组件解决动态生效修改配置秒级生效多维度支持 IP / 用户 / 应用 / Token低侵入一个注解即可接入高性能高 QPS 场景无感知可审计操作可追溯三、整体架构┌──────────────┐ │ 管理后台 │ └──────┬───────┘ │ ┌──────▼───────┐ │ 配置中心 │ (Nacos / Apollo) └──────┬───────┘ │ 推送 ┌─────────▼─────────┐ │ 白名单治理组件 │ │ (Starter) │ └──────┬───────┬───┘ │ │ ┌──────▼───┐ ┌─▼────────┐ │ Gateway │ │ 业务服务 │ └──────────┘ └──────────┘四、白名单模型设计4.1 核心数据结构publicclassWhiteListRule{privateStringbizCode;// 业务标识privateRuleTyperuleType;// IP / USER / APPprivateSetStringvalues;// 白名单值privatebooleanenabled;}publicenumRuleType{IP,USER_ID,APP_ID}五、组件使用方式重点5.1 注解定义Target({ElementType.METHOD,ElementType.TYPE})Retention(RetentionPolicy.RUNTIME)publicinterfaceWhiteList{StringbizCode();booleanenabled()defaulttrue;}5.2 使用示例WhiteList(bizCodeORDER_CREATE)PostMapping(/order/create)publicOrderDTOcreateOrder(){returnorderService.create();}⚠️Controller / Service 都可用低侵入六、核心拦截逻辑6.1 AOP 拦截Around(annotation(whiteList))publicObjectaround(ProceedingJoinPointpjp,WhiteListwhiteList)throwsThrowable{WhiteListRulerulewhiteListManager.getRule(whiteList.bizCode());if(rulenull||!rule.isEnabled()){returnpjp.proceed();}booleanpassruleMatcher.match(rule);if(!pass){thrownewBizException(无白名单权限);}returnpjp.proceed();}七、匹配策略设计7.1 策略接口publicinterfaceWhiteListMatchStrategy{booleanmatch(WhiteListRulerule);}7.2 IP 示例publicclassIpMatchStrategyimplementsWhiteListMatchStrategy{Overridepublicbooleanmatch(WhiteListRulerule){StringipRequestContext.getClientIp();returnrule.getValues().contains(ip);}}典型策略模式八、配置动态更新8.1 配置中心Nacos / ApolloJSON 结构存储支持推送{ORDER_CREATE:{ruleType:IP,values:[10.1.1.1,10.1.1.2],enabled:true}}8.2 本地缓存ConcurrentHashMapString,WhiteListRuleLOCAL_CACHE;启动加载监听变更原子替换九、高并发优化点点方案读取纯内存锁无锁设计热点本地缓存性能单次判断 0.1ms2W QPS 无压力十、网关层 vs 服务层10.1 网关层IP 黑白名单全局流量挡板10.2 服务层推荐业务语义清晰可精细到方法级不依赖网关最佳实践两层都要十一、审计与治理操作人操作时间变更前 / 后变更原因建议独立表whitelist_audit_log十二、常见坑白名单写死在代码里 ❌修改必须发版 ❌DB 实时查 ❌无兜底开关 ❌十三、总结一句话统一白名单治理 注解 AOP 策略模式 本地缓存 配置中心