同源策略(Same-Origin Policy)是浏览器最核心的安全功能,它限制了从一个源加载的文档或脚本如何与另一个源的资源进行交互。所谓“同源”,指协议(protocol)、域名(domain)、端口(port)三者必须完全一致。
例如:
• https://api.xservx.com 与 https://www.xservx.com → 不同源(子域名不同)
• https://api.xservx.com:443 与 https://api.xservx.com → 同源(443为HTTPS默认端口)
• http://api.xservx.com 与 https://api.xservx.com → 不同源(协议不同)
试想:若无同源策略,恶意网站可通过JavaScript读取银行网站的登录表单DOM,窃取用户输入的账号密码;或利用iframe嵌入支付页面,通过脚本模拟点击完成非授权支付——这将彻底摧毁Web安全根基。
因此,同源策略是浏览器的“防火墙”,而跨域解决方案必须在保障安全的前提下,通过明确授权机制(如CORS响应头)实现可控通信。
CORS(Cross-Origin Resource Sharing,跨源资源共享)是W3C标准,通过HTTP响应头告知浏览器是否允许跨域请求。其本质是“服务端主动声明信任关系”,浏览器据此决定是否放行响应数据。
关键响应头:
• Access-Control-Allow-Origin:允许的源(如*或https://www.xservx.com)
• Access-Control-Allow-Methods:允许的HTTP方法(如GET,POST,PUT)
• Access-Control-Allow-Headers:允许的请求头字段(如Content-Type,Authorization)
• Access-Control-Allow-Credentials:是否允许携带Cookie(值为true时,Allow-Origin不能为*)
GET、POST、HEADAccept、Accept-Language、Content-Language、Content-Type(且值为application/x-www-form-urlencoded、multipart/form-data、text/plain)流程:
1. 浏览器直接发送跨域请求
2. 服务端返回响应头中包含Access-Control-Allow-Origin
3. 浏览器检查该头,若匹配当前源则允许访问响应数据
// 示例:简单POST请求
POST /api/data HTTP/1.1
Host: api.xservx.com
Origin: https://www.xservx.com
Content-Type: application/json
{"name":"test"}
X-Custom-Header)PUT、DELETE、PATCH等方法Content-Type为application/json等非简单类型流程:
1. 浏览器先发OPTIONS预检请求
2. 服务端响应允许的头、方法、是否支持凭证
3. 浏览器确认无误后,才发送真实请求
// 预检请求示例
OPTIONS /api/data HTTP/1.1
Host: api.xservx.com
Origin: https://www.xservx.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: Content-Type, Authorization
通过Access-Control-Max-Age头可缓存预检结果(单位:秒),减少重复预检开销。例如:
Access-Control-Max-Age: 86400 → 缓存24小时
注意:若服务端动态变更CORS策略(如临时禁用某源),需等待缓存过期才生效,可能影响紧急修复。
适用于所有Java Web容器(Tomcat/Jetty/Undertow),无需框架依赖。
import javax.servlet.*;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
public class CorsFilter implements Filter {
@Override
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
throws IOException, ServletException {
HttpServletResponse response = (HttpServletResponse) res;
response.setHeader("Access-Control-Allow-Origin", "https://www.xservx.com");
response.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
response.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
response.setHeader("Access-Control-Allow-Credentials", "true");
response.setHeader("Access-Control-Max-Age", "86400");
chain.doFilter(req, res);
}
}
web.xml配置:
<filter>
<filter-name>CorsFilter</filter-name>
<filter-class>com.example.CorsFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>CorsFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
适用于临时修复或特殊路径,但无法统一管理。
@GetMapping("/api/data")
public ResponseEntity getData() {
HttpServletResponse response = ((ServletRequestAttributes) RequestContextHolder
.currentRequestAttributes()).getResponse();
response.setHeader("Access-Control-Allow-Origin", "*");
response.setHeader("Access-Control-Allow-Methods", "GET,POST");
return ResponseEntity.ok(new Data("test"));
}
注意:使用HttpServletResponse需注意空指针风险,且无法处理OPTIONS预检请求。
public class CorsFilter implements Filter {
@Override
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
throws IOException, ServletException {
HttpServletResponse response = (HttpServletResponse) res;
HttpServletRequest request = (HttpServletRequest) req;
// 允许所有源(生产环境建议指定具体域名)
response.setHeader("Access-Control-Allow-Origin", "*");
response.setHeader("Access-Control-Allow-Methods", "POST, GET, PUT, OPTIONS, DELETE");
response.setHeader("Access-Control-Max-Age", "3600");
response.setHeader("Access-Control-Allow-Headers",
"Content-Type, Authorization, X-Requested-With");
// 处理OPTIONS请求(直接返回200)
if ("OPTIONS".equalsIgnoreCase(request.getMethod())) {
response.setStatus(HttpServletResponse.SC_OK);
return;
}
chain.doFilter(req, res);
}
}
spring:
mvc:
cors:
enabled: true
configurations:
default:
allowed-origin-patterns: "https://www.xservx.com"
allowed-methods: "GET,POST,PUT,DELETE"
allowed-headers: "*"
allow-credentials: true
max-age: 3600
优点:配置集中,无需修改代码;
注意:allowed-origin-patterns支持通配符(如*.xservx.com),比allowed-origins更灵活。
@RestController
@RequestMapping("/api")
@CrossOrigin(
origins = "https://www.xservx.com",
methods = {RequestMethod.GET, RequestMethod.POST},
allowedHeaders = {"Content-Type", "Authorization"},
allowCredentials = "true"
)
public class DataController {
@GetMapping("/data")
public Data getData() {
return new Data("test");
}
}
适用场景:
• 仅特定接口需跨域
• 不同Controller配置不同策略
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/api/**")
.allowedOriginPatterns("https://*.xservx.com", "http://localhost:*")
.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
.allowedHeaders("*")
.allowCredentials(true)
.maxAge(3600);
}
}
优势:
• 支持路径匹配(/api/**)
• 可配置多组规则
• 兼容旧版Spring Boot
fetch(url, {credentials: 'include'})或axios.defaults.withCredentials = trueOPTIONS并返回200allowCredentials=true时,Access-Control-Allow-Origin必须是明确域名,不可为*server {
listen 80;
server_name api.xservx.com;
location /api/ {
proxy_pass http://backend:8080;
# 添加CORS头
add_header Access-Control-Allow-Origin "https://www.xservx.com" always;
add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS" always;
add_header Access-Control-Allow-Headers "Content-Type, Authorization" always;
add_header Access-Control-Allow-Credentials "true" always;
add_header Access-Control-Max-Age "86400" always;
# 处理预检请求
if ($request_method = OPTIONS) {
return 204;
}
}
}
适用场景:
• 多后端服务统一跨域策略
• 非Java服务(如Node.js/Python)统一接入
• 避免代码侵入性修改
map $http_origin $cors_origin {
default "";
"~https://www.xservx.com" "https://www.xservx.com";
"~https://dev.xservx.com" "https://dev.xservx.com";
}
server {
location /api/ {
add_header Access-Control-Allow-Origin $cors_origin always;
add_header Access-Control-Allow-Credentials "true" always;
# 其他配置...
}
}
JSONP(JSON with Padding)利用<script>标签不受同源策略限制的特性实现跨域。服务端返回一个函数调用,前端通过回调函数接收数据。
致命缺陷:
• 仅支持GET请求
• 无法处理错误(HTTP状态码被忽略)
• 存在XSS风险(执行第三方脚本)
• 不支持POST、PUT等方法
@GetMapping("/jsonp/data")
public ResponseEntity jsonpData(@RequestParam String callback) {
String json = "{\"name\":\"test\",\"value\":123}";
return ResponseEntity.ok()
.contentType(MediaType.APPLICATION_JSON)
.body(callback + "(" + json + ")");
}
前端调用:
<script>function handleData(data){ console.log(data); }</script>
<script src="https://api.xservx.com/jsonp/data?callback=handleData"></script>
callback参数(仅允许字母数字下划线)前端开发时通过代理将请求转发至后端,浏览器认为请求同源(访问localhost),绕过跨域限制。
// vite.config.js
export default {
server: {
proxy: {
'/api': {
target: 'https://api.xservx.com',
changeOrigin: true,
secure: false,
rewrite: path => path.replace(/^\/api/, '')
}
}
}
}
注意:
• 仅适用于开发环境,生产环境需用真实代理(如Nginx)
• changeOrigin: true确保请求头Host为目标域名
将前端静态资源与后端API部署在同一域名下,通过路径区分:
https://www.xservx.com/ → 前端页面
https://www.xservx.com/api/ → 后端接口
Nginx配置示例:
location /api/ { proxy_pass http://backend:8080; }
SameSite=Lax(默认):禁止第三方请求携带Cookie(如A网站通过img标签请求B网站API)SameSite=None; Secure:允许跨站请求携带Cookie(需HTTPS)SameSite=Strict:完全禁止跨站携带CookieJava后端设置:
response.addHeader("Set-Cookie", "token=abc123; Path=/; HttpOnly; Secure; SameSite=None");
Chrome 80+默认屏蔽第三方Cookie,导致跨域场景下:
• 跨域登录态无法保持
• 跨域埋点数据丢失
• OAuth授权流程中断
解决方案:
1. 使用SameSite=None; Secure(需用户主动信任站点)
2. 改用Token认证(JWT存储在localStorage)
3. 通过重定向实现单点登录(SSO)
// 后端CORS配置
Access-Control-Allow-Origin: https://www.xservx.com
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Content-Type, Authorization
// Cookie设置
Set-Cookie: session_id=xyz789; Path=/; HttpOnly; Secure; SameSite=None
前端请求需携带凭证:
fetch('https://api.xservx.com/api/user', { credentials: 'include' })
CORS仅控制“浏览器是否允许前端读取响应数据”,但服务端仍需执行完整安全校验:
• 认证(Authentication):验证用户身份
• 授权(Authorization):验证操作权限
• 请求校验:防止CSRF/XSS/注入攻击
关键区别:
• CORS无法阻止跨域请求发送(浏览器仍可发POST)
• CSRF攻击利用浏览器自动携带Cookie的特性
• 即使CORS配置宽松,也必须校验CSRF Token
Access-Control-Allow-Origin: *(除非公开API)Origin头 + CSRF TokenAccess-Control-Allow-Credentials: true时,Origin必须明确指定Access-Control-Max-Age)Origin: https://www.xservx.comAccess-Control-Allow-Origin| 错误现象 | 原因 | 解决方案 |
|---|---|---|
| No 'Access-Control-Allow-Origin' header | 服务端未添加CORS响应头 | 添加Access-Control-Allow-Origin头 |
| The value of the 'Access-Control-Allow-Origin' header is invalid | Origin与响应头不匹配 | 检查allowedOrigin是否精确匹配 |
| Request header field Authorization is not allowed | 未在Access-Control-Allow-Headers中声明 | 添加Authorization到允许头 |
| Credentials flag is 'true', but the 'Access-Control-Allow-Origin' header is '*' | Credentials与通配符冲突 | 将*改为具体域名 |
# 测试预检请求
curl -I -X OPTIONS https://api.xservx.com/api/data \
-H "Origin: https://www.xservx.com" \
-H "Access-Control-Request-Method: POST"
# 测试真实请求
curl -v https://api.xservx.com/api/data \
-H "Origin: https://www.xservx.com"
× 错误!跨域限制由浏览器实施,但解决方案需服务端配合(设置CORS头)
✓ 正确:前端仅能发起请求,服务端必须明确授权
× 错误!同源请求无需此头;后端服务间调用(如微服务通信)不受同源策略限制
✓ 正确:仅浏览器发起的跨域AJAX需服务端响应CORS头
× 错误!简单POST(Content-Type为application/x-www-form-urlencoded等)无需预检
✓ 正确:Content-Type为application/json时才触发预检
× 错误!CORS仅控制响应读取,不阻止请求发送
✓ 正确:CSRF防护需依赖Token/Double Submit Cookie等机制
× 错误!CORS自IE10+起全面支持,现代浏览器无兼容问题
<img>、<video>加载跨域资源(但无法读取像素数据)<script>实现跨域数据获取(历史方案)Content-Security-Policy(CSP)与CORS互补:
• CORS控制“能否读取响应”
• CSP控制“能否加载资源”
例如:
Content-Security-Policy: img-src 'self' https://cdn.xservx.com → 仅允许加载指定域名图片
在微服务架构中,API Gateway(如Kong/Nginx)常统一处理跨域:
• 统一添加CORS响应头
• 统一认证鉴权
• 统一日志埋点
优点:后端服务无需重复处理跨域逻辑
A:推荐使用开发代理(Vite/Webpack),生产环境用Nginx反向代理或服务端CORS配置。避免在生产环境使用JSONP。
A:检查三点:
1. 响应头是否含Access-Control-Allow-Credentials: true
2. 前端请求是否设置credentials: 'include'
3. Cookie的SameSite=None; Secure是否正确设置
A:服务端未处理OPTIONS预检请求。需在Filter或Controller中拦截OPTIONS方法并返回204状态码。
A:按顺序检查:
1. 浏览器Network标签 → 查看预检请求的响应头
2. 确认Access-Control-Allow-Origin值是否与请求Origin完全匹配
3. 检查是否有多个Filter叠加导致头被覆盖