groingio web端跨域

### 解决GroingIO Web端跨域问题

#### CORS 设置方法

对于 GroingIO Web 应用程序中的跨域资源共享 (CORS)，可以通过多种方式配置。一种常见的做法是在服务器端通过实现 `WebMvcConfigurer` 接口并重写 `addCorsMappings` 方法来进行全局 CORS 配置[^3]。

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**") // 允许所有路径的跨域请求
            .allowedOrigins("https://groingio-client.example.com") // 替换成实际客户端地址
            .allowedMethods("GET", "POST", "PUT", "DELETE")
            .allowedHeaders("*")
            .allowCredentials(true)
            .maxAge(3600);
    }
}

此代码片段展示了如何允许来自特定源 (`https://groingio-client.example.com`) 的跨域请求，并指定了允许的方法和头文件，同时也启用了凭证支持以及设置了预检请求的最大缓存时间为一小时。

#### 常见错误排查

当遇到跨域问题时，可以按照以下几点进行排查：

- **检查响应头**：确保服务器返回了正确的 CORS 相关 HTTP 头部字段，比如 `Access-Control-Allow-Origin` 和其他必要的头部。

- **验证配置生效范围**：确认 CORS 配置已经应用到目标 API 上；如果仅部分接口需要开启，则应针对性调整 `.addMapping()` 中指定的具体 URI 模式而非通配符 `"/*"` 或者 `"/**"`。

- **浏览器控制台日志**：查看开发者工具网络面板下的具体报错信息，通常能提供关于违反哪些同源策略限制的重要线索。

- **测试环境差异**：有时本地开发环境中一切正常但在生产环境下却出现问题，这可能是由于部署后的域名、协议或端口号发生了变化所引起的跨域冲突。