gRPC Web+Envoy+Spring Boot gRPC Server CORS配置无效求助

部署环境 #

• 运行在6565端口的gRPC Server
• 运行在8080端口的Envoy代理，配置了CORS规则（allow_origin_string_match 设置为 prefix: "*"）
• 运行在8811端口的gRPC Web客户端

错误信息 #

浏览器控制台输出：

localhost/:1 Access to XMLHttpRequest at 'http://localhost:8080/calculator.CalculatorService/findSquare' from origin 'http://localhost:8811' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource.
bundle.js:1136 Uncaught TypeError: Cannot read properties of null (reading 'getResult')

已配置允许所有源的CORS规则，但仍提示缺少Access-Control-Allow-Origin头，请求排查原因及解决方法。

排查原因及解决方法 #

核心原因分析 #

1. CORS匹配规则错误：Envoy中prefix: "*"是前缀匹配逻辑，仅匹配以*开头的Origin，无法覆盖正常的源（如http://localhost:8811），不是“允许所有源”的正确配置方式。
2. CORS过滤器未关联到目标路由：即使全局配置了CORS规则，如果处理gRPC-Web请求的路由未启用CORS过滤器，规则也不会生效。
3. OPTIONS预请求未被正确处理：gRPC-Web请求会触发OPTIONS预请求，若Envoy未配置对应处理逻辑，预请求返回的响应会缺少CORS头。

具体解决步骤 #

1. 修正CORS匹配规则

将allow_origin_string_match中的prefix: "*"替换为exact: "*"，确保匹配所有源。完整CORS配置示例：

cors:
  allow_origin_string_match:
  - exact: "*"
  allow_methods: GET, POST, OPTIONS
  allow_headers: keep-alive,user-agent,cache-control,content-type,content-transfer-encoding,x-accept-content-transfer-encoding,x-accept-response-streaming,x-user-agent,x-grpc-web,grpc-timeout
  expose_headers: grpc-status,grpc-message

2. 确保路由启用CORS过滤器

在处理gRPC-Web请求的路由配置中，添加CORS过滤器的关联配置：

routes:
- match:
    prefix: "/"
  route:
    cluster: grpc_server
  typed_per_filter_config:
    envoy.filters.http.cors:
      "@type": type.googleapis.com/envoy.extensions.filters.http.cors.v3.CorsPolicy

3. 配置OPTIONS请求的直接响应

添加专门处理OPTIONS预请求的路由，快速返回符合要求的CORS响应头：

routes:
- match:
    prefix: "/"
    headers:
    - name: ":method"
      exact_match: OPTIONS
  direct_response:
    status: 200
    headers:
    - name: Access-Control-Allow-Origin
      value: "*"
    - name: Access-Control-Allow-Methods
      value: GET, POST, OPTIONS
    - name: Access-Control-Allow-Headers
      value: keep-alive,user-agent,cache-control,content-type,content-transfer-encoding,x-accept-content-transfer-encoding,x-accept-response-streaming,x-user-agent,x-grpc-web,grpc-timeout

4. 验证配置有效性

重启Envoy后，用curl发送OPTIONS请求测试：

curl -X OPTIONS http://localhost:8080/calculator.CalculatorService/findSquare \
  -H "Origin: http://localhost:8811" \
  -H "Access-Control-Request-Method: POST" \
  -H "Access-Control-Request-Headers: x-grpc-web,content-type"

检查响应头是否包含Access-Control-Allow-Origin: *，确认配置生效。

内容的提问来源于stack exchange，提问作者Syed Rafi