spring boot中静态资源映射与跨域配置应分离处理：默认支持classpath:/static、/public、/resources、/meta-inf/resources四路径（优先级递减），外部目录通过webmvcconfigurer的addresourcehandlers映射；跨域推荐全局webmvcconfigurer配置，allowedorigins显式指定可信域名，禁用*配合allowcredentials，maxage设3600优化预检缓存。
在 Spring Boot 中优雅处理静态资源映射和跨域配置，关键在于分清职责、避免硬编码、兼顾开发与生产环境的安全性。静态资源映射解决的是前端文件（如 HTML、JS、CSS、图片）的访问路径问题；跨域配置解决的是浏览器同源策略下前后端分离部署时的接口通信问题。两者常共存，但应独立配置、互不干扰。
静态资源映射：用好默认规则，按需扩展
Spring Boot 默认已支持多级静态资源路径，无需额外配置即可直接访问：
- classpath:/static —— 最常用，存放前端构建产物（如 Vue/React 打包后的 dist 内容）
- classpath:/public —— 适合放公开资源，如 robots.txt、favicon.ico
- classpath:/resources —— 一般用于配置类资源，也可放静态文件
- classpath:/META-INF/resources —— 遵循 Servlet 规范，优先级最高
若需映射外部目录（如上传的图片），推荐通过 WebMvcConfigurer 扩展：
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
String imagePath = System.getProperty("user.home") + "/uploads/";
File dir = new File(imagePath);
if (!dir.exists()) dir.mkdirs();
registry.addResourceHandler("/uploads/**")
.addResourceLocations("file:" + imagePath);
}
注意：路径前缀（如 /uploads/**）必须以 / 开头，且 addResourceLocations 中的 file: 协议不能省略。
跨域配置：优先全局，慎用通配符
最推荐的方式是实现 WebMvcConfigurer，统一管理所有接口的跨域规则：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
@Configuration
public class CorsConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOrigins("http://localhost:3000", "https://your-app.com")
.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
.allowedHeaders("*")
.allowCredentials(true)
.maxAge(3600);
}
}
重点说明：
-
allowedOrigins 不要用
"*"配合allowCredentials(true)，否则浏览器会拒绝请求；生产环境必须显式列出可信域名 -
maxAge设为 3600 可缓存预检结果，减少重复 OPTIONS 请求 - 路径映射
"/**"覆盖所有接口，包括 Actuator 端点，如有需要可细化为"/api/**"
特殊场景：局部跨域或动态源控制
当只有个别接口需不同规则，或源地址需运行时判断（如从请求头提取 Origin 并校验白名单），可用以下方式：
- 在 Controller 类或方法上加
@CrossOrigin注解，参数与全局配置一致，但仅作用于该处 - 自定义
CorsConfigurationSourceBean，配合CorsFilter实现逻辑判断，例如读取数据库白名单或请求头中的租户标识
不建议在 Controller 中混用注解与全局配置，容易引发覆盖行为难以调试。
避坑提醒：常见组合问题
静态资源和跨域看似无关，但实际联调中易出问题：
- 前端直接打开
index.html（file:// 协议）访问后端接口 → 浏览器将file://视为非法源，allowedOrigins必须包含null（不推荐，应改用本地服务起页面） - 静态资源路径与 API 路径冲突（如都配了
/api/**）→ 静态资源处理器优先级低于 MVC，确保addResourceHandler的路径不覆盖接口路由 - Nginx 反向代理时已处理跨域 → Spring Boot 内部无需再配 CORS，否则可能重复添加响应头导致报错
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
