同一个任务的列表 / 详情 / 回执是三个不同的出参类型——列表不带材料全文、回执不含联系方式，「返回什么」在 VO 类型层收敛，不靠调用方自觉。

public TaskSummaryVO insert(TaskInsertIPO ipo) { ... }      // 列表条目：摘要字段
public TaskDetailVO getDetail(String taskId) { ... }        // 详情：材料全文 + 签名图片地址
public List<TaskMineVO> mine(String reporterId) { ... }    // 回执：状态摘要 + 本人自述

doFilterInternal(request, response, chain) 已提供参数必须直接使用——通过 RequestContextHolder ThreadLocal 获取 request/response 时，RequestContextFilter 的执行顺序不保证早于自定义 Filter，ThreadLocal 未就绪会导致 NPE。写回响应用 Result.response(nativeResponse) 带参版本，禁止无参版本（内部走 ThreadLocal，可能返回 null）。

裸用无参版本时 Spring Boot 检测方法返回类型的 raw class（泛型擦除后），对 FilterRegistrationBean<X> 等泛型 Bean 会退化为检测 FilterRegistrationBean——容器中存在任意同类 Bean 就跳过目标创建（静默失效）。意图是「配置开关控制 Bean 创建」时优先 @ConditionalOnProperty。排查「Bean 静默未创建」第一步看 ConditionEvaluationReport（启动参数 --debug）。

@Bean
@ConditionalOnMissingBean                        // 泛型擦除后检测 raw class，同类 Bean 存在即静默跳过
public FilterRegistrationBean<XxxFilter> xxxFilter() { ... }

@Bean
@ConditionalOnMissingBean(XxxFilter.class)      // 显式类型，精确判定
public FilterRegistrationBean<XxxFilter> xxxFilter() { ... }

自动配置引用非强制依赖的 Bean 时，必须 @ConditionalOnBean(X.class) + @Autowired(required = false) 双保险。@Resource 是强制注入（JSR-250 不支持 required=false），对可选依赖必须改用 @Autowired(required = false)，否则依赖缺失时容器启动失败。

构造 HttpServletRequestWrapper 缓存 body 字节实现「请求体可重复读」时，body 缓存与 getParts() 参数解析互斥（二者都独占容器底层流的唯一一次可读性；Tomcat 的 multipart 解析不走 Wrapper 覆盖的 getInputStream()）。必须按 content-type 感知处理、默认跳过 multipart 包装，无差别包装会导致参数读到空 body 或文件上传损坏两类静默错误。