使用OpenTelemetry Collector Contrib时遭遇CORS错误，求排查方案

排查思路 #

• 核对配置语法兼容性：原生Collector与Contrib版本的OTLP Receiver配置可能存在细微差异，检查cors配置的层级、字段拼写是否符合当前Contrib版本的规范，比如是否存在字段名大小写、嵌套层级错误。
• 查看Collector启动日志：启动Contrib Collector时，观察控制台或日志文件，确认是否有CORS配置加载失败的报错信息，比如提示cors配置项无效，以此判断配置是否被正确解析。
• 验证端口占用情况：使用系统命令检查4318端口是否被Contrib Collector独占，避免其他服务抢占端口导致OTLP HTTP服务未正常启动。
• 测试预请求响应：用curl手动发送OPTIONS预请求到http://localhost:4318/v1/traces，查看响应头中是否包含Access-Control-Allow-Origin，以此定位是Collector配置问题还是前端请求问题。

解决方案 #

1. 完善CORS配置项 #

Contrib版本的OTLP Receiver可能需要更完整的CORS配置才能处理预请求，补充允许的请求方法和头部：

receivers:
  otlp:
    protocols:
      http:
        cors:
          allowed_origins:
            - http://localhost:3000
          allowed_methods: ["POST", "OPTIONS"]
          allowed_headers: ["Content-Type", "X-Requested-With", "Accept"]
          max_age: 7200
        endpoint: 0.0.0.0:4318
exporters:
  debug:
    verbosity: detailed
service:
  pipelines:
    traces:
      receivers: [otlp]
      exporters: [debug]
    metrics:
      receivers: [otlp]
      exporters: [debug]
    logs:
      receivers: [otlp]
      exporters: [debug]

2. 匹配版本一致性 #

将Contrib Collector版本切换为与原生效的原生Collector版本一致的版本，避免因版本差异导致的配置兼容问题。

3. 确认配置加载路径 #

确保Contrib Collector启动时加载的是你修改后的配置文件，而非默认配置。启动时显式指定配置文件路径，比如：

otelcol-contrib --config=./your-config.yaml

4. 排查网络拦截因素 #

确认本地是否有代理、防火墙或浏览器插件拦截了请求，导致CORS头未正常返回。可以尝试关闭代理、防火墙，或使用浏览器无痕模式测试。

内容的提问来源于stack exchange，提问作者Jad Chahine