Web 跨域与网络配置

页面与事件接收地址的协议、域名或端口不同时，接收端须配置 CORS，允许该页面来源访问。

配置

向接收端负责人提供以下信息：

页面来源：https://shop.example.com
接收地址：https://collector.example.com
环境：测试环境

页面来源或接收地址变更后，应更新配置。

验证

1. 在浏览器开发者工具的 Network（网络） 面板中检查 OPTIONS 预检和事件请求。
2. 请接收端确认测试事件已收到。请求返回成功不代表事件已入库，其他验证方式见数据校验。

常见问题

现象	检查项
OPTIONS 失败或没有事件请求	页面来源、允许方法、允许请求头和预检响应。
事件请求已发送，但浏览器报告 CORS 错误	成功及错误响应是否均包含 CORS 响应头。
没有事件请求	SDK 初始化、授权状态、浏览器网络策略。

网关配置

将 Access-Control-Allow-Origin 配置为接入页面的 Origin，并允许 POST、OPTIONS。SDK 上报不携带 Cookie，Access-Control-Allow-Headers 可设为 *；预检请求无需项目凭据。

预检、成功响应及错误响应均须包含适用的 CORS 响应头。如需 SDK 读取限流响应中的 Retry-After，须通过 Access-Control-Expose-Headers 暴露该字段。若同一接口还接收携带凭据的请求，应单独配置来源、凭据策略和请求头允许列表。