从开发视角看安全：我的Spring Boot项目是如何一步步防御XSS、CSRF和越权的？
从开发视角看安全：我的Spring Boot项目是如何一步步防御XSS、CSRF和越权的？
在构建现代Web应用时，安全防护不再是可选项而是开发流程的核心环节。作为长期使用Spring Boot框架的后端开发者，我深刻体会到安全措施必须融入项目生命周期的每个阶段——从架构设计的第一张草图到生产环境的每一次部署。本文将分享一个博客系统的实战案例，展示如何通过代码级解决方案系统性地防御XSS、CSRF和越权这三大Web安全威胁。
1. XSS防御：从被动拦截到主动编码
XSS攻击的本质是恶意脚本的注入执行，传统防护往往依赖过滤特殊字符的黑名单机制。但在Spring Boot生态中，更有效的策略是输出编码与**内容安全策略（CSP）**的双重保障。
1.1 Thymeleaf的自动HTML转义
Thymeleaf模板引擎默认开启HTML转义，这是防御存储型和反射型XSS的第一道防线。当我们在模板中输出变量时：
<div th:text="${userContent}"></div> <!-- 等价于手动转义 --> <div th:utext="${#strings.escapeXml(userContent)}"></div>但需要注意几个特殊场景：
- 在JavaScript代码块中输出动态内容需额外处理
- 使用
th:utext时需要确保内容绝对可信 - 富文本编辑器的内容需要白名单过滤而非简单转义
1.2 响应头的安全加固
通过Content-Security-Policy响应头可以进一步限制资源加载：
@Bean SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { http.headers(headers -> headers .contentSecurityPolicy(policy -> policy .policyDirectives("default-src 'self'; script-src 'self' 'unsafe-inline'") ) ); return http.build(); }关键配置项说明：
| 指令 | 作用 | 推荐值 |
|---|---|---|
| default-src | 默认加载策略 | 'self' |
| script-src | 控制JS执行 | 'self' nonce-{随机值} |
| style-src | 控制CSS加载 | 'self' 'unsafe-inline' |
| img-src | 图片资源限制 | 'self' data: |
1.3 富文本的XSS过滤
对于博客内容这类需要保留HTML格式的场景，Jsoup库提供了完善的白名单机制：
private String sanitizeHtml(String input) { Whitelist whitelist = Whitelist.basicWithImages() .addTags("div", "span") .addAttributes(":all", "style", "class"); return Jsoup.clean(input, whitelist); }2. CSRF防护：Spring Security的深度集成
CSRF攻击利用的是浏览器的同源策略和会话保持机制。Spring Security提供了开箱即用的防护方案，但需要根据业务场景进行定制。
2.1 默认防护机制
启用CSRF防护只需简单配置：
@Bean SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { http.csrf(csrf -> csrf .csrfTokenRepository(CookieCsrfTokenRepository.withHttpOnlyFalse()) ); return http.build(); }这种配置会：
- 生成
XSRF-TOKENcookie - 要求修改请求（POST/PUT等）携带
X-XSRF-TOKEN头 - 自动验证令牌的有效性
2.2 前后端分离的特殊处理
对于RESTful API架构，推荐使用以下优化方案：
.csrf(csrf -> csrf .csrfTokenRepository(new CookieCsrfTokenRepository()) .csrfTokenRequestHandler(new SpaCsrfTokenRequestHandler()) ) // 自定义处理器 class SpaCsrfTokenRequestHandler extends CsrfTokenRequestAttributeHandler { @Override public void handle(HttpServletRequest request, HttpServletResponse response, Supplier<CsrfToken> csrfToken) { // 为API请求跳过CSRF检查 if (request.getRequestURI().startsWith("/api/")) { return; } super.handle(request, response, csrfToken); } }2.3 关键操作的双重验证
对于敏感操作（如密码修改），建议增加以下措施：
// 在表单中添加二次确认字段 <input type="hidden" name="confirmToken" th:value="${confirmToken}"> // 服务端验证 @PostMapping("/change-password") public String changePassword(@RequestParam String confirmToken, HttpSession session) { String sessionToken = (String) session.getAttribute("confirmToken"); if (!sessionToken.equals(confirmToken)) { throw new InvalidRequestException(); } // 处理密码修改逻辑 }3. 越权防护：注解驱动的访问控制
越权漏洞分为水平越权（同权限用户间访问）和垂直越权（低权限访问高权限功能）。Spring Security提供了细粒度的解决方案。
3.1 方法级权限控制
使用@PreAuthorize注解实现声明式权限检查：
@PreAuthorize("hasRole('ADMIN') or #userId == authentication.principal.id") @GetMapping("/users/{userId}/profile") public UserProfile getProfile(@PathVariable Long userId) { // 只有管理员或本人可访问 } @PreAuthorize("@permissionChecker.canAccessProject(#projectId)") @PostMapping("/projects/{projectId}/delete") public void deleteProject(@PathVariable String projectId) { // 自定义权限逻辑 }3.2 数据级权限过滤
对于列表查询，需要在数据访问层进行过滤：
public interface PostRepository extends JpaRepository<Post, Long> { @Query("SELECT p FROM Post p WHERE p.author.id = ?#{principal.id} " + "OR p.visibility = 'PUBLIC'") List<Post> findAccessiblePosts(Pageable pageable); }3.3 权限缓存优化
频繁的权限检查可能影响性能，可通过缓存策略优化：
@Cacheable(value = "userPermissions", key = "#userId") public Set<String> loadUserPermissions(Long userId) { // 从数据库加载权限 return permissionRepository.findByUserId(userId) .stream() .map(Permission::getCode) .collect(Collectors.toSet()); }4. 安全开发的持续集成
安全措施需要贯穿整个开发周期，以下是我们团队的实践方案：
4.1 自动化安全测试
在CI流水线中加入安全检查：
# .gitlab-ci.yml stages: - security dependency-check: stage: security image: owasp/dependency-check script: - dependency-check.sh --project MyApp --scan ./src - python security_tests.py4.2 依赖项漏洞扫描
使用OWASP Dependency-Check监控第三方库风险：
# 定期检查依赖 mvn org.owasp:dependency-check-maven:check4.3 安全代码审查清单
每个Pull Request必须通过以下检查：
- [ ] 所有用户输入都经过验证或编码
- [ ] 敏感操作有CSRF防护
- [ ] 权限检查覆盖所有API端点
- [ ] 错误消息不暴露系统信息
- [ ] 密码等敏感信息使用强哈希存储
在项目初期，我们曾因未对JSONP接口做权限检查导致信息泄露。后来通过建立代码审查机制，类似问题在测试阶段就能被发现。安全不是一次性的工作，而是需要持续投入的工程实践。