Sentinel常见问题排查指南：规则不生效、热点限流与集群流控

1. 规则不生效问题排查

典型症状：配置了流控规则但未触发预期效果

排查步骤

资源名匹配检查

确保代码中的资源名与规则完全一致（包括大小写）

// 代码中的资源定义
try (Entry entry = SphU.entry("orderService")) {
  // 业务逻辑
}

// 规则配置必须使用相同名称
FlowRule rule = new FlowRule("orderService")...

规则加载验证

// 检查已加载规则
List<FlowRule> rules = FlowRuleManager.getRules();
rules.forEach(rule -> {
    System.out.println(rule.getResource() + " : " + rule.getCount());
});

作用域确认
- 注解方式需确保类被Spring管理
- AOP代理问题检查（CGLIB vs JDK动态代理）

实践建议：

使用Sentinel Dashboard实时查看规则是否生效
开启日志调试（添加JVM参数：-Dcsp.sentinel.log.use.pid=true）

2. 热点参数限流失效解决方案

核心要点：参数必须通过Entry显式传递

正确用法示例

// 必须指定参数类型和值
Entry entry = null;
try {
    entry = SphU.entry("resName", EntryType.IN, 1, orderId);
    // 业务处理
} catch (BlockException ex) {
    // 处理限流
} finally {
    if (entry != null) {
        entry.exit();
    }
}

常见错误：

未设置EntryType.IN（必须是IN类型）
参数位置错误（必须是第4个参数）
使用基本类型而非包装类型

高级配置：

// 热点规则配置示例
ParamFlowRule rule = new ParamFlowRule("resName")
    .setParamIdx(0)  // 参数索引
    .setCount(5);    // 阈值
ParamFlowRuleManager.loadRules(Collections.singletonList(rule));

3. 集群流控异常处理

架构示意图：

关键检查点

服务端配置：

# 启动Token Server模式
-Dproject.name=cluster-server -Dcsp.sentinel.metric.server.port=9090

客户端配置：

# 指向Token Server
-Dcsp.sentinel.dashboard.server=localhost:9090
-Dcsp.sentinel.log.dir=./logs

网络连通性测试：

telnet token-server-ip 9090
curl http://token-server-ip:9090/cluster/client/info

故障排查表：

现象	可能原因	解决方案
获取Token超时	网络延迟	检查防火墙/网络策略
频繁限流	Server负载高	扩容Token Server节点
规则不同步	版本不一致	统一客户端版本

生产建议：

部署Token Server集群保证高可用
配置合理的namespace隔离不同应用
监控Token Server的QPS和响应时间

综合调试技巧

实时监控：

// 获取当前资源统计
ClusterNode node = ClusterBuilderSlot.getClusterNode("resName");
System.out.println("PassQPS: " + node.passQps());

动态调整（通过API）：

# 动态修改规则
curl -X POST http://dashboard-ip:8080/setRules?type=flow -d '[{"resource":"test","count":10}]'

日志分析：

# 查看详细决策日志
grep "ClusterFlowCheck" logs/sentinel-record.log

通过系统化的排查方法，可以快速定位和解决Sentinel在生产环境中的各类配置问题。建议结合Dashboard的实时监控功能进行验证，并建立规则变更的自动化测试流程。

Sentinel问题排查：规则不生效、热点限流与集群流控