/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}
Spring Web综合实战与性能调优详解
定位：第 08 篇汇总 Web 层高频踩坑、性能调优维度、安全基线与接口设计纪律 适用版本：Spring Framework 6.x（JDK 17+）
目录
- 一、高频踩坑
- 二、性能调优
- 三、Web 安全基线
- 四、接口设计纪律
- 五、总结
- 六、常见高频面试题
一、高频踩坑
1.1 参数类
| 参数绑定失败/为 null | @RequestBody 与表单混用、参数名不匹配 | 对齐数据来源与注解（02 篇） |
| 恶意字段被写入 | 对象绑定批量赋值漏洞 | 入参用专门 DTO，不含敏感字段 |
| 类型转换 400 | 日期/枚举格式不匹配 | 自定义 Converter/格式化，明确约定 |
1.2 序列化类
| 日期格式不一致 | 默认序列化与前端约定不符 | 全局配置 Jackson 日期格式 |
| 循环引用死循环 | 双向关联实体直接序列化 | 返回 DTO，不序列化实体 |
| 空字段冗余 | 默认输出全部字段 | @JsonInclude 按需 |
纪律：接口永远返回 DTO，不直接序列化实体（避免泄露、循环引用、表结构耦合）。
1.3 异常与线程类
| 500 堆栈直接返回 | 无全局异常处理 | @RestControllerAdvice 兜底（04 篇） |
| 吞吐上不去 | 阻塞调用占满 Web 线程 | 异步化/线程池隔离/虚拟线程 |
| 异步里拿不到上下文 | 上下文不跨线程 | 装饰器快照恢复（FW-07） |
1.4 配置类
| 下游慢拖垮接口 | 客户端未配超时 | 所有出站调用配超时 |
| 大文件上传失败 | 大小限制过小 | 调大或走对象存储（05 篇） |
| 发布期请求失败 | 无优雅停机 | server.shutdown=graceful（BT-05） |
二、性能调优
2.1 调优维度（按收益）
① 减少处理成本：
响应压缩（gzip/br）、接口缓存（幂等读）、序列化精简
② 线程模型：
Web 线程池匹配并发、慢依赖异步化、JDK21 虚拟线程
③ 传输层：
Keep-Alive 复用连接、HTTP/2、CDN 分流静态资源
④ 依赖调用：
合并下游（批量）、并行编排、本地/分布式缓存
2.2 观测先行
必配指标：QPS、延迟分位数（P99）、错误率、线程池/连接池水位
慢接口清单：按耗时分位数排序逐个优化
无观测的调优是盲调（呼应可观测纪律）
三、Web 安全基线
| 输入校验 | 全部入参校验（03 篇），不信任客户端 |
| 输出编码 | 渲染用户内容防 XSS；接口返回注意敏感字段 |
| 认证鉴权 | Spring Security（SE 主题），最小权限 |
| CSRF | 状态变更请求防护（浏览器会话场景） |
| 敏感数据 | 日志/响应/错误信息不外泄密码、堆栈、内部细节 |
| 依赖漏洞 | 跟进 CVE，及时升级（依赖扫描工具） |
四、接口设计纪律
① 状态码与错误体对齐语义（03 篇），客户端可编程处理
② 幂等性显式声明：幂等接口可重试，非幂等加幂等键
③ 版本兼容：加字段兼容，破坏性变更升版本
④ 文档化：OpenAPI（springdoc）自动生成，契约即文档
⑤ 契约测试：消费者驱动的契约测试防集成回归
五、总结
六、常见高频面试题
1. 为什么接口要返回 DTO 而不是直接返回实体？
要点：三个原因。① 安全——实体全字段序列化会泄露内部字段（密码、内部状态）；② 结构耦合——表结构变化直接冲击 API 契约，返回 DTO 隔离内外模型；③ 序列化问题——双向关联实体会循环引用，懒加载字段触发异常。DTO 只含接口需要的字段，是 Web 层的基本纪律。代价是要维护映射（手写/MapStruct）。
2. Web 应用接口慢，如何系统性排查？
要点：观测先行——看延迟分位数定位慢接口；再分层归因：① 应用内：是否阻塞了 Web 线程（慢逻辑、锁）、线程池是否打满；② 依赖：下游接口/DB 耗时（链路追踪定位瓶颈跳）、慢 SQL/N+1；③ 传输：序列化大对象、无压缩；④ 资源：GC 频繁、连接池不足。工具：链路追踪、慢日志、线程 dump、JVM 监控。原则：用证据定位，不猜。
3. 如何提升 Web 应用的并发吞吐？
要点：按层施策。① 线程模型：Web 容器线程池匹配并发与耗时；慢依赖异步化（@Async、异步 Servlet、响应式）；JDK21 用虚拟线程让同步模型高并发；② 依赖调用：并行编排多个下游、批量化、加缓存减少依赖次数；③ 传输：Keep-Alive、压缩、HTTP/2；④ 无状态化便于水平扩容。先量化瓶颈（线程在等什么）再选手段。
4. 什么是批量赋值漏洞？Web 层如何防？
要点：对象绑定（@ModelAttribute/表单）会按客户端提供的参数设置目标对象的任意可写字段——若直接绑定实体，攻击者可传 role=ADMIN、isDeleted=false 等篡改不该开放的字段。防御：入参用专门的 DTO，只含允许客户端设置的字段；不把实体直接作入参；敏感字段默认值由服务端控制。这是与 SQL 注入、XSS 并列的常见 Web 漏洞。
5. 接口的幂等性怎么设计？
要点：幂等指同一请求执行一次与多次效果相同。GET/PUT/DELETE 天然幂等；非幂等的创建/扣减类操作要显式设计：① 幂等键——客户端传唯一键（如订单号/请求 ID），服务端按键去重（唯一索引/缓存）；② 状态机前置校验——已到达目标态则直接返回成功；③ 数据库原子操作 + 唯一约束兜底。网关/前端重试依赖幂等性，金融类操作必须幂等。
6. 如何做接口的版本管理与兼容？
要点：策略：URI 版本（/v1/、/v2/，最常用）或请求头版本。兼容纪律：加字段向后兼容（老客户端忽略新字段）；删字段、改类型、改语义必须升版本；旧版本保留过渡期并公告下线。配合契约测试（消费者驱动）在集成层面捕获不兼容。目标：演进不破坏存量客户端。
7. Web 层有哪些常见安全漏洞与防护？
要点：① SQL 注入——参数化查询/ORM；② XSS——输出编码、内容安全策略；③ CSRF——状态变更请求带令牌（Spring Security 内置）；④ 批量赋值——入参 DTO 白名单；⑤ 敏感信息泄露——错误不回堆栈、日志不打密码；⑥ 认证鉴权缺陷——统一用安全框架、最小权限；⑦ 依赖漏洞——跟进 CVE。原则：不信任任何输入，纵深防御。
8. 如何自动生成和维护接口文档？
要点：用 OpenAPI（springdoc-openapi）从代码自动生成规范文档——控制器注解、入参出参模型、校验注解都可被解析成 OpenAPI 描述，提供 Swagger UI 交互浏览。维护纪律：代码即文档（注解写清摘要与示例）、把文档生成纳入构建、与契约测试配合。避免手写文档与代码脱节。
9. 响应压缩有必要吗？注意什么？
要点：对文本类响应（JSON/HTML）开启压缩（gzip/br）能显著减小传输体积，提升弱网体验。注意：① 小响应压缩收益小、反增 CPU，可按大小阈值开启；② 已压缩内容（图片）无需再压；③ 注意代理链是否重复压缩；④ 服务端压缩占 CPU，高负载下可交给网关/CDN 做。属于低成本高收益的传输优化。
10. 压测 Web 服务时关注哪些指标？如何判定瓶颈？
要点：核心指标：吞吐（QPS）、延迟分位数（P50/P99/P999）、错误率、资源（CPU/内存/GC）、线程池与连接池水位。判定瓶颈：延迟陡增或错误率抬头的拐点即容量上限；结合线程状态（大量 WAITING 说明在等依赖）、GC 频率、池水位定位瓶颈层。压测要梯度加压、留基线、压测机自身不先饱和。结论用于容量规划与调优验证。
