跨域注解（CrossOrigin Annotation）通常是指在 Web 开发中，通过特定的注解（Annotation）或装饰器（Decorator）来配置跨域资源共享（CORS, CrossOrigin Resource Sharing）策略，以解决浏览器同源策略（SameOrigin Policy）带来的跨域问题。

一、什么是跨域？

当一个请求的协议、域名、端口与当前页面不一致时，就会触发浏览器的 同源策略，导致请求被拦截。例如：

前端地址：`http://localhost:3000`
后端地址：`http://localhost:8080`

前端向后端发起请求时，会遇到跨域限制。

二、跨域解决方案

常见的跨域解决方案包括：

1、使用 CORS（推荐）
2、JSONP（已逐渐淘汰）
3、代理服务器
4、浏览器禁用安全策略（仅开发环境）

其中，CORS 是最主流、最标准的方式，它通过 HTTP 头信息控制跨域访问权限。

三、使用跨域注解配置 CORS（常见于 Java / Spring Boot）

✅ Spring Boot 中的 `@CrossOrigin` 注解

这是最常见的“跨域注解”。

java
@RestController
@RequestMapping(/api)
@CrossOrigin(origins = http://localhost:3000) // 允许来自该域名的跨域请求
public class UserController {

@GetMapping(/users)
public List<User getAllUsers() {
return userService.findAll();
}
}

参数说明：

| 参数 | 说明 |

| `origins` | 允许的来源（如 `http://localhost:3000`），默认允许所有 |
| `methods` | 允许的 HTTP 方法（如 `{RequestMethod.GET, RequestMethod.POST}`） |
| `allowedHeaders` | 允许的请求头 |
| `exposedHeaders` | 暴露给客户端的响应头 |
| `allowCredentials` | 是否允许携带凭证（如 Cookie） |
| `maxAge` | 预检请求（preflight）缓存时间（秒） |

🔧 全局配置 CORS（推荐用于生产环境）

虽然 `@CrossOrigin` 很方便，但更推荐使用全局配置来统一管理 CORS 策略。

java
@Configuration
@EnableWebMvc
public class CorsConfig implements WebMvcConfigurer {

@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping(/api/**)
.allowedOrigins(http://localhost:3000)
.allowedMethods(GET, POST, PUT, DELETE, OPTIONS)
.allowedHeaders(*)
.exposedHeaders(XCustomHeader)
.allowCredentials(true)
.maxAge(3600);
}
}

四、其他语言/框架中的“跨域注解”

1、Node.js / Express（使用中间件代替注解）

虽然没有注解，但你可以使用 `cors` 中间件：

js
const cors = require('cors');
app.use(cors({
origin: 'http://localhost:3000',
credentials: true
}));

2、NestJS（受 Spring 启发的 Node.js 框架）

支持类似 Spring 的注解：

ts
@UseGuards(JwtAuthGuard)
@UseInterceptors(ClassSerializerInterceptor)
@Controller('users')
@HttpController({ cors: true }) // 或者具体配置
export class UsersController {}

五、总结

| 技术栈 | 跨域配置方式 |

| Spring Boot | `@CrossOrigin` 注解 + 全局配置 |
| NestJS | 类似 Spring 的注解 |
| Express | 使用 `cors` 中间件 |
| Flask (Python) | 使用 `flaskcors` 插件 |
| Django | 使用 `djangocorsheaders` 包 |

如果你有具体的开发框架或语言需求，我可以给出更详细的跨域注解示例。欢迎继续提问！