静态代码块在类加载初始化阶段执行且仅一次，适合轻量级ip黑名单初始化；它天然线程安全、不依赖spring、无i/o开销，适用于固定ip列表的快速兜底过滤。
静态代码块在类加载时执行一次，适合做轻量级、启动即固定、无需动态更新的 IP 黑名单初始化。它不依赖 Spring 容器、不涉及配置中心或远程调用，适用于对实时性要求不高、黑名单极少变动的场景（比如测试环境封禁本地调试地址、内网固定运维IP等）。
为什么选静态代码块？
它天然满足“只加载一次、类一加载就生效”的特性，比普通成员变量初始化更早，且无需构造函数或 Bean 生命周期管理。特别适合纯工具类或过滤器中快速兜底加载一组已知恶意 IP。
- 避免 Spring 初始化前无法注入的问题（对比 @Component 过滤器）
- 不依赖配置文件解析或外部存储，无 I/O 开销
- 线程安全：JVM 保证静态块在类初始化阶段单次、同步执行
- 内存占用极小，适合几十条以内的 IP 列表
如何定义并加载黑名单集合
推荐使用 HashSet
示例代码：
public class IpBlacklist {
// 静态集合，类加载时初始化
public static final Set<string> BLACKLIST = new HashSet();
// 静态代码块：仅执行一次，加载预设IP
static {
BLACKLIST.add("127.0.0.1");
BLACKLIST.add("0:0:0:0:0:0:0:1"); // IPv6 localhost
BLACKLIST.add("192.168.1.100");
BLACKLIST.add("203.0.113.5"); // 示例恶意IP
// 可继续添加，但不宜超过百条
}
// 工具方法：快速判断
public static boolean isBlocked(String ip) {
return ip != null && BLACKLIST.contains(ip.trim());
}
}</string>
如何在过滤器中调用预过滤逻辑
将上述工具类与标准 Filter 结合，在 doFilter 中直接调用 IpBlacklist.isBlocked(ip) 即可。无需额外初始化，也不受 Spring 上下文限制。
- 获取真实客户端 IP：务必用
getRemoteAddr()+ 补充 X-Forwarded-For 解析（参考 IpUtils 工具类） - 匹配前做 trim() 和空值校验，防止空格或 null 导致误放行
- 若命中黑名单，直接写响应并 return，不再调用 filterChain.doFilter()
- 建议记录被拦截日志（含时间、IP、URI），便于后续审计
注意事项与局限
静态代码块方式简单直接，但有明确边界：
- 黑名单无法热更新 —— 修改后必须重启应用
- 不支持 CIDR 网段匹配（如 192.168.1.0/24），只能精确匹配字符串
- 未做 IP 归一化（如 127.0.0.01 不等于 127.0.0.1），生产环境慎用于对外服务
- IPv6 缩写格式（如 ::1）需与实际请求中的格式完全一致才能匹配
适合内部系统、开发联调、CI/CD 测试网关等低风险、低变更频次场景。需要动态能力时，应转向 Nacos + 监听器 或 Redis + 布隆过滤器方案。
