K8s独立部署OPA无法被Envoy边车触发执行授权策略的问题排查
核心问题排查结论
当前所有现象的根因是Envoy无法连通OPA服务,ext_authz过滤器在集群不可达时直接触发默认拒绝逻辑,请求根本没有送达OPA进程,和授权策略、JWT校验逻辑、后端应用配置都无关。
关键故障点定位
- 缺失OPA对应的K8s Service资源:Envoy配置中OPA集群采用
STRICT_DNS类型,通过主机名opa寻址9191端口的gRPC服务,但你当前仅部署了OPA的Deployment,没有创建对应的K8s Service。
K8s集群内的Pod要解析opa这个主机名,必须存在和Deployment同命名空间、匹配app: opa标签选择器的Service,否则DNS解析直接失败,Envoy根本拿不到OPA的Pod IP,无法建立gRPC连接。 - 故障表现完全匹配上述逻辑:
- 收到的403响应头
server: envoy、空响应体,正是ext_authz过滤器的默认失败策略——当授权后端集群不可达时,过滤器不会尝试转发请求到后端应用,也不会向OPA发请求,直接返回403。 - OPA侧完全没有收到授权请求、没有决策日志,也直接印证了连接从未建立,请求根本没跨网络到达OPA容器。
- 收到的403响应头
- 排除其他干扰项:
- 如果是OPA策略校验不通过返回的403,OPA一定会打印对应的决策日志,和你当前观测到的“无决策日志”现象矛盾。
- 后端应用如果直接返回403,响应头不会是
server: envoy,也会带应用自身的响应特征,和当前返回头不匹配。
修复操作步骤
- 补全OPA的K8s Service配置,明确暴露gRPC端口:
部署这个Service后,集群内的Pod就可以将apiVersion: v1 kind: Service metadata: name: opa spec: selector: app: opa ports: - name: ext-authz-grpc port: 9191 targetPort: 9191 - name: http port: 8181 targetPort: 8181opa主机名正确解析到OPA的Pod IP,建立9191端口的gRPC连接。 - 连通性验证:
- 登录跑example-app的Pod的Envoy容器,访问Envoy的admin端口(配置中监听8001端口),查询
/clusters接口,确认opa集群的端点状态为健康、可用端点数为1。 - 直接在容器内测试
curl -v opa:9191,确认网络连通没有被拦截。 - 如果补完Service后连通性仍然失败,检查集群是否配置了NetworkPolicy,拦截了example-app Pod到OPA Pod的9191端口的入站流量。
- 登录跑example-app的Pod的Envoy容器,访问Envoy的admin端口(配置中监听8001端口),查询
- 确认过滤器默认行为:ext_authz过滤器的
failure_mode_allow参数默认是false,也就是授权集群不可达时直接拒绝请求,不需要额外修改,只要确认配置中没有误设为true导致逻辑异常即可。
内容的提问来源于stack exchange,提问作者user15202490
相关产品推荐
相关产品推荐

