06.8.2.3 Spring Data、Security 与测试
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.8 Kotlin 后端 / 06.8.2 Spring Boot 与 Kotlin
本节要解决的问题
- Spring Data JPA 实体、仓库与查询在 Kotlin 写法下有哪些特化约束和坑?
- Spring Security 的 Kotlin 配置 DSL 如何写授权、登录与过滤器链?
- Kotlin 测试栈(kotlin-test/Kotest、mockk、协程测试)如何与 Spring 测试集成?
版本前提:Spring Boot 3.2+ / Spring Data JPA 3.x / Spring Security 6.x / Kotlin 2.x / JDK 17+。JPA 映射、Security 过滤器链、事务传播等通用原理见 06.2 分册,本节只写 Kotlin 写法差异与边界。版本敏感项标「待确认」。
06.8.2.3-001 JPA 实体直接写成 Kotlin data class 有哪些坑?
一句话结论
data class 按主构造器字段生成 equals/hashCode/toString/copy,与 JPA 的代理、懒加载、状态变更和关联循环冲突;实体应使用普通类(或谨慎裁剪 data class),把相等性与业务标识解耦。
概念解释
JPA 实体是持久化状态对象:需要无参构造、可写字段、代理子类化、懒加载关联。data class 的结构相等性把关联字段纳入比较,copy 生成脱离持久化上下文的新对象,toString 可能遍历懒加载关联。
原理流程
- JPA 通过无参构造实例化并回填字段。
- 实体可能被代理子类化,字段访问受状态机控制。
- data class 生成的相等性/字符串方法不感知持久化状态。
- 关联遍历可能触发懒加载或循环。
代码或图示
// 不推荐:实体直接 data class,相等性与 toString 含关联
@Entity
data class Order(@Id val id: Long, val items: List<OrderItem>)
// 更稳妥:普通类,字段按需可写,相等性按业务标识实现
@Entity
@Table(name = "orders")
open class Order(
@Id @Column(name = "id") val id: Long,
@OneToMany(mappedBy = "order") val items: MutableList<OrderItem> = mutableListOf(),
)
常见误区
- 用
copy()复制实体当修改:副本不在持久化上下文,不会被脏检查跟踪。 - data class 相等性比较两个代理实体:可能因代理与字段加载状态不同而不等。
追问
- DTO 能用 data class 吗?答:可以,DTO 是数据载体,正是 data class 的恰当场景。
- 实体相等性怎么实现?答:按主键/业务唯一标识实现
equals/hashCode,避免关联字段参与;通用实体映射原理见 06.2。
06.8.2.3-002 JPA 实体为什么需要 noarg 插件生成无参构造?
一句话结论
Hibernate 反射实例化实体时调用无参构造,Kotlin 主构造器带参数时编译器不额外生成无参构造;noarg 插件为 @Entity 等注解类合成无参构造,供框架回填字段。
概念解释
实体创建路径是「反射 new 空实例 → 字段回填」。Kotlin 默认只生成声明的构造器,缺无参构造会在持久化时报无默认构造器错误。noarg 合成构造不执行业务初始化,仅服务反射实例化。
原理流程
- 实体类标注
@Entity纳入 noarg 配置。 - 编译期合成无参构造。
- Hibernate 反射调用无参构造创建空实例。
- 按结果集回填字段。
代码或图示
@Entity
open class User(
@Id val id: Long,
var name: String,
) // noarg 合成无参构造,源码不体现
常见误区
- 以为实体加默认参数就等于有无参构造:默认参数生成的是带参重载,不等同反射可用的无参构造(待确认编译器产物细节)。
- 只配 allopen 不配 noarg:代理能继承,但实例化仍失败。
追问
- allopen 与 noarg 在实体上各管什么?答:allopen 管代理子类化开放,noarg 管反射无参构造,二者常同时配置。
- 合成构造会初始化字段默认值吗?答:受插件配置影响,以 noarg 官方文档为准(待确认)。
06.8.2.3-003 JPA 实体为什么不适合全部字段用 val?
一句话结论
持久化框架需要在实例化后回填字段、更新状态并初始化懒加载代理,全 val 主构造器字段没有可写入口;实体的可变状态字段应使用 var,不可变标识字段可用 val。
概念解释
val 只能在构造期赋值,但实体对象先被空构造创建再回填,后续脏检查也需要写字段。主键等创建后不变的字段可用 val,名称、状态、关联等需变更的字段用 var。
原理流程
- 无参构造创建空实例,字段处于初始状态。
- 框架回填可写字段。
- 实体更新时
var字段被修改并纳入脏检查。 val字段构造后不可改,仅用于不可变列。
代码或图示
@Entity
open class Profile(
@Id val id: Long, // 不可变标识
var displayName: String, // 可变状态
var bio: String? = null, // 可空可变
)
常见误区
- 全部
val指望构造器一次性赋值:与无参构造回填路径冲突。 - 可变业务字段写成
val:更新无法落库。
追问
- 不可变实体可行吗?答:只读查询场景可设计不可变模型,但更新型实体仍需可写字段;不可变实体映射方式见下一条。
var字段封装访问吗?答:可在实体内提供业务方法修改状态,字段保持包内可见。
06.8.2.3-004 不可变实体在 Hibernate 中如何映射?
一句话结论
只读/不可变场景可让字段构造期定稿,配合只读实体视图或 DTO 投影;需要被 Hibernate 状态机管理的实体仍需可写访问入口,纯不可变对象更适合作为投影结果而非受管实体。
概念解释
Hibernate 实体跟踪字段变化,依赖可写访问。不可变对象没有回填/更新入口,通常用于查询投影(接口投影、DTO 构造器映射),而不是受管持久化实体。把不可变 data class 当实体用会遇到构造与代理问题。
原理流程
- 受管实体:可写字段 + 无参构造 + 代理开放。
- 只读投影:查询结果直接映射为不可变 data class。
- 不可变对象不纳入持久化上下文脏检查。
- 更新操作回到实体或领域模型完成。
代码或图示
// 受管实体:可变
@Entity open class Account(@Id val id: Long, var balance: BigDecimal)
// 查询投影:不可变 data class
data class AccountView(val id: Long, val balance: BigDecimal)
常见误区
- 期望不可变 data class 直接承受懒加载与更新:Hibernate 状态机不支持。
- 把投影对象当实体传入保存:脱离上下文,需重新加载或转换。
追问
- 只读实体注解有哪些?答:
@Immutable/只读视图等 Hibernate 能力,通用映射原理见 05 分册。 - 不可变领域模型如何落库?答:实体与领域模型分离,转换器负责双向映射。
06.8.2.3-005 属性访问与字段访问在 Kotlin 实体上表现有何不同?
一句话结论
字段访问直接读写后端字段,属性访问经 getter/setter;Kotlin 属性编译出 getter/setter,选择访问策略影响注解落点、代理注入与懒加载初始化,实体应保持访问策略一致。
概念解释
@Access 指定 Hibernate 读取/写入字段还是属性。Kotlin var 属性有合成 getter/setter,属性访问策略下框架通过方法访问;字段访问直接操作字段。关联与列注解落点要与策略匹配。
原理流程
- 实体类或字段标注访问策略。
- 字段访问:Hibernate 反射字段。
- 属性访问:调用 getter/setter。
- 懒加载代理拦截属性访问方法。
代码或图示
@Entity
@Access(AccessType.FIELD)
open class Product(
@Id val id: Long,
var title: String,
)
常见误区
- 类用属性访问,注解却标在字段上:映射落点不一致。
- Kotlin 自定义 getter 中做业务逻辑:属性访问时被框架回调触发。
追问
- 两种策略能混用吗?答:可在字段/属性级别覆盖,但保持一致更易维护。
- 懒加载在哪种策略下代理?答:属性访问通过拦截 getter 初始化代理,字段访问依赖字段级代理,通用懒加载见 05 分册。
06.8.2.3-006 实体继承体系在 Kotlin 中需要注意什么?
一句话结论
实体父类与子类默认 final 会阻碍代理与继承映射;继承映射(JOINED/SINGLE_TABLE 等)要求类可被继承,父类字段与关联的映射注解要随继承体系正确放置。
概念解释
JPA 继承映射涉及子类化实体体系。Kotlin 默认封闭,父类/子类需经 allopen 或显式 open;继承策略、鉴别列、共享字段映射在父类定义,子类补充自身列。
原理流程
- 父类标注继承策略与共享字段。
- 子类继承父类并补充列映射。
- 实体类开放可被代理继承。
- 查询按继承体系映射到子类实例。
代码或图示
@Entity
@Inheritance(strategy = InheritanceType.JOINED)
open class Billing(
@Id val id: Long,
var amount: BigDecimal,
)
@Entity
open class CardBilling(id: Long, amount: BigDecimal, val last4: String) : Billing(id, amount)
常见误区
- 子类漏写
open:代理子类化失败。 - 共享字段重复映射到子类:列冲突。
追问
- MappedSuperclass 怎么用?答:父类不映射为表,字段被子类继承映射;通用继承策略见 05 分册。
- 抽象实体类需要无参构造吗?答:继承体系同样受 noarg 规则约束,按实体注解配置。
06.8.2.3-007 关联关系字段的可空性与集合类型如何选择?
一句话结论
一对一/多对一关联按是否可为空声明 T?;集合关联用只读 List 声明类型、内部持有可变 MutableList 实现初始化,避免集合为 null 并明确空集合语义。
概念解释
关联可空性对应外键是否可空。集合关联不应声明为 null 集合,初始化空集合即可。Kotlin 只读集合类型对外表达不可变,内部可变实现供关联维护使用。
原理流程
- 单值关联:外键可空 →
var relation: Target?。 - 集合关联:
var items: MutableList<Item> = mutableListOf()。 - 对外暴露
List<Item>只读视图。 - 关联维护方法负责双向一致。
代码或图示
@Entity
open class Order(
@Id val id: Long,
@ManyToOne var customer: Customer?,
@OneToMany(mappedBy = "order")
val items: MutableList<OrderItem> = mutableListOf(),
)
常见误区
- 集合字段声明可空
List<Item>?:遍历前判空增加负担,初始化为空集合更合理。 - 双向关联只维护一侧:内存中关联不一致,持久化结果异常。
追问
- 集合泛型可空元素?答:
List<Item?>表达元素可为空,按外键可空性决定。 - 懒加载集合在序列化前初始化?答:避免会话外触发懒加载,通用 N+1 与懒加载见 05 分册。
06.8.2.3-008 关联集合用 List 还是 MutableList 映射?
一句话结论
字段实现类型选 MutableList 供 Hibernate 代理与关联维护,对外接口暴露只读 List;映射集合的实现类型影响代理包装,声明 List 类型仍可由框架注入可变代理集合。
概念解释
Hibernate 用持久化集合代理包装关联集合。字段声明只读 List 不影响内部可变实现;暴露给服务层时返回只读视图,防止外部随意修改关联。集合顺序与索引语义按映射策略确定。
原理流程
- 实体字段持有可变集合实现。
- Hibernate 注入持久化集合代理。
- 服务层通过实体方法维护关联。
- 对外返回只读集合引用或拷贝。
代码或图示
@OneToMany(mappedBy = "order")
val items: MutableList<OrderItem> = mutableListOf()
fun itemView(): List<OrderItem> = items.toList()
常见误区
- 外部直接拿到内部 MutableList 并增删:绕过实体关联维护逻辑。
- 集合未初始化导致关联为 null:新增关联时 NPE。
追问
- Set 与 List 关联区别?答:Set 去重无序,List 可带索引排序;通用集合映射见 05 分册。
- 持久化集合代理能强制转换吗?答:不要假设具体实现类型,按接口操作。
06.8.2.3-009 枚举列在 Kotlin 实体中如何映射?
一句话结论
枚举字段用 Kotlin enum class,配合 @Enumerated 按名字或序数持久化;推荐按名字(STRING)存储,避免枚举顺序调整导致历史数据错位。
概念解释
JPA 枚举映射两种策略:EnumType.STRING 存常量名,EnumType.ORDINAL 存序号。序号随枚举声明顺序变化风险高,生产优先字符串;枚举值作为类型安全的有限状态。
原理流程
- 定义 Kotlin 枚举类。
- 实体字段声明枚举类型并标注映射策略。
- 持久化时按策略转换列值。
- 读取时反向解析枚举常量。
代码或图示
enum class OrderStatus { PENDING, PAID, SHIPPED }
@Entity
open class Order(
@Id val id: Long,
@Enumerated(EnumType.STRING)
var status: OrderStatus = OrderStatus.PENDING,
)
常见误区
- 用 ORDINAL 又调整枚举顺序:历史行序号对应错误常量。
- 新增枚举值未同步数据库约束/校验:非法状态落库。
追问
- 枚举名与列值风格不一致?答:可自定义转换器映射命名风格,通用 Converter 机制见 05 分册。
- 枚举可空怎么写?答:
var status: OrderStatus? = null,对应可空外键/状态列。
06.8.2.3-010 findById 返回 Optional 在 Kotlin 中如何处理?
一句话结论
Spring Data 仓库返回 Java Optional<T>,Kotlin 侧可直接用可空类型接收并 elvis 降级,或通过扩展 findByIdOrNull 把 Optional 转为可空值,避免在 Kotlin 代码里反复操作 Optional。
概念解释
Optional 是 Java 兼容类型,Kotlin 更自然的表达是可空类型。仓库方法返回 Optional,边界转换为 T?,服务层用 ?: 或 requireNotNull 处理缺失。扩展函数收敛转换细节。
原理流程
- 仓库
findById返回Optional<User>。 - Kotlin 侧
.orElse(null)转为可空,或扩展findByIdOrNull。 - 服务层判空走降级或抛领域异常。
- 不把 Optional 泄漏到业务逻辑深处。
代码或图示
fun UserRepository.findByIdOrNull(id: Long): User? =
findById(id).orElse(null)
val user: User? = repository.findByIdOrNull(id)
常见误区
- 在 Kotlin 代码里连续
get()/isPresent判断:违背 Kotlin 空安全习惯。 - 把 Optional 当可空类型直接赋值:类型不匹配,需先转换。
追问
- 缺失记录抛什么异常?答:领域NotFoundException,由全局处理器映射 404;通用异常处理见 06.1。
- 仓库接口能直接声明返回可空吗?答:可自定义仓库方法返回领域类型,框架按实现转换;具体派生规则见 Spring Data 文档。
06.8.2.3-011 仓库扩展函数如何封装「返回 null 而非 Optional」?
一句话结论
在仓库接口上定义 Kotlin 扩展函数调用默认方法/父接口方法,把 Optional 或结果包装为可空;扩展不改变仓库代理机制,只是边界适配层,保持仓储接口返回 Java 兼容类型。
概念解释
扩展函数挂在 Spring Data 仓库接口上,内部调用继承的 CRUD 方法并转换结果。服务层只依赖可空 Kotlin 类型,Optional 细节收敛在扩展层。扩展不能替代自定义仓库片段实现复杂查询。
原理流程
- 仓库接口继承基础 CRUD 接口。
- 定义扩展函数调用
findById等。 - 转换结果为可空类型返回。
- 服务层调用扩展函数。
代码或图示
interface UserRepository : CrudRepository<User, Long>
fun UserRepository.findNicknameOrNull(id: Long): String? =
findById(id).orElse(null)?.nickname
常见误区
- 在扩展函数里写复杂 JPQL:复杂查询应走仓库方法声明或自定义片段。
- 扩展函数访问仓库代理内部状态:只能调用接口暴露方法。
追问
- 扩展函数能被 Spring Data 代理增强吗?答:扩展是静态包装,不经过代理增强;事务等增强仍在仓库/服务方法上。
- 多个仓库共用转换扩展?答:放通用扩展包,按接口泛型约束编写。
06.8.2.3-012 Spring Data 派生查询在 Kotlin 接口中怎么声明?
一句话结论
仓库接口方法按 findBy/ExistsBy/CountBy 关键词 + 属性名声明,Spring Data 根据方法名派生查询;Kotlin 属性名与实体字段对应,可空返回表达可能查不到结果。
概念解释
派生查询无需手写 SQL,方法名解析为条件子句。Kotlin 接口方法用表达式体或抽象声明,参数绑定条件值;返回集合、可空单值或 Optional 表达结果基数。
原理流程
- 仓库接口继承仓库基础接口。
- 声明派生方法,属性路径与关键字组合。
- 启动期解析方法名生成查询。
- 运行期按参数执行查询并映射结果。
代码或图示
interface OrderRepository : JpaRepository<Order, Long> {
fun findByStatus(status: OrderStatus): List<Order>
fun findByCustomerIdAndStatus(customerId: Long, status: OrderStatus): Order?
}
常见误区
- 属性名拼错:启动期派生解析失败报方法名无法匹配属性。
- 单值方法可能返回多条:派生方法取单值,多条结果抛异常。
追问
- 派生方法支持哪些关键字?答:And/Or/Between/Like/In/OrderBy 等,通用派生规则见 Spring Data 文档。
- 返回
List还是MutableList?答:声明List即可,实现由框架提供。
06.8.2.3-013 JPQL 查询引用 Kotlin 实体字段名有什么注意点?
一句话结论
JPQL 使用实体属性名(Kotlin 属性)而非数据库列名;查询中的属性路径对应实体类属性,投影与参数绑定按属性类型,列名只出现在原生 SQL 中。
概念解释
@Query JPQL 面向实体模型,join 路径写关联属性。Kotlin 属性名在编译后保留,查询引用属性名;写错列名或关联路径在启动/运行期解析失败。
原理流程
- 仓库方法标注
@QueryJPQL。 - 查询中的实体名、属性路径映射到实体模型。
- 参数按位置或名称绑定。
- 结果映射为实体或投影类型。
代码或图示
@Query("select o from Order o where o.customer.id = :customerId")
fun findByCustomer(customerId: Long): List<Order>
常见误区
- JPQL 里写数据库列名:实体模型上不存在该属性,解析失败。
- 关联路径写错属性名:查询编译期/运行期报错。
追问
- 命名参数怎么写?答:
:name配合@Param("name"),Kotlin 参数名保留需编译配置。 - 原生 SQL 与 JPQL 区分?答:
nativeQuery = true用列名,否则 JPQL 用属性名。
06.8.2.3-014 Specification 组合在 Kotlin 中如何写更简洁?
一句话结论
Spring Data JPA Specification 可配合 Kotlin DSL 风格构造条件谓词,按属性组装 Predicate;复杂动态查询用 Specification 组合,单条件派生查询或 JPQL 更简单。
概念解释
Specification 把查询条件抽象为可组合谓词。Kotlin 可用扩展与局部函数封装重复条件片段,避免匿名内部类样板。组合方式:AND/OR 拼接多个 Specification,动态条件按需加入。
原理流程
- 定义条件 Specification 片段。
- 按查询参数存在性组合片段。
Specification.where(...)聚合。- 仓库
findAll(spec, pageable)执行。
代码或图示
fun hasStatus(status: OrderStatus?): Specification<Order>? =
status?.let { Specification { root, _, cb -> cb.equal(root.get<OrderStatus>("status"), it) } }
常见误区
- 所有查询都上 Specification:简单固定条件用派生方法更清晰。
- 动态条件忽略 null 判断:空参数生成不必要的过滤条件。
追问
- Querydsl 与 Specification 取舍?答:类型安全查询可选用 Querydsl 生态;通用查询构建器见 05 分册。
- Specification 支持排序分页吗?答:配合
Pageable传入,规格只负责条件。
06.8.2.3-015 Specification 的 where/and/or 如何组合?
一句话结论
空安全组合:基础条件用 Specification.where,片段间 and/or 拼接;null 片段表示不参与条件,避免把 null 谓词拼进查询造成逻辑错误。
概念解释
动态查询参数可选,片段可能不存在。组合时跳过 null 片段,最终谓词按 AND 叠加。Kotlin 可空类型让「片段缺失」在类型层面显式表达。
原理流程
- 各可选条件产出可空 Specification。
- 初始条件为 where(基础片段) 或 null。
- 非空片段依次
and拼接。 - 最终规格传给查询。
代码或图示
val spec = hasCustomer(customerId)?.let { Specification.where(it) }
?.and(hasStatus(status))
?: Specification.where(null)
常见误区
- 直接对 null Specification 调
and:产生 null 谓词,查询行为不确定。 - OR 条件嵌套层级错误:优先级不符合预期,需显式分组。
追问
- 组合顺序影响 SQL 吗?答:AND/OR 结合律与括号分组决定谓词优先级。
- 复杂 OR 分组怎么写?答:构造复合 Specification 片段显式分组。
06.8.2.3-016 接口投影与 DTO 构造器投影在 Kotlin 中怎么选?
一句话结论
接口投影声明 getter 由 Spring Data 动态代理填充;DTO 构造器投影(接口/类构造器匹配查询列)映射为 data class 实例;返回 DTO data class 更符合 Kotlin 习惯,接口投影适合轻量只读视图。
概念解释
投影只取需要的列,避免加载整实体。接口投影运行期生成代理实现;构造器投影把列按构造器参数映射到不可变 data class。后者类型明确、可直接序列化给前端。
原理流程
- 查询选择投影字段。
- 接口投影:动态代理实现 getter。
- 构造器投影:匹配构造器参数名/列映射实例化。
- 结果作为只读视图返回服务层。
代码或图示
data class OrderSummary(val id: Long, val status: OrderStatus, val amount: BigDecimal)
@Query("select o.id as id, o.status as status, o.amount as amount from Order o")
fun findSummaries(): List<OrderSummary>
常见误区
- 投影里仍触发懒加载关联:投影只映射选定列,避免关联遍历。
- 构造器投影参数名与查询别名不一致:映射失败。
追问
- 接口投影能加方法逻辑吗?答:默认方法可基于 getter 计算,通用投影机制见 05 分册。
- DTO 投影能直接返回前端吗?答:data class 可序列化,但注意脱敏与字段暴露。
06.8.2.3-017 分页 Page 在 Kotlin 中如何使用?
一句话结论
仓库返回 Page<T>,包含内容、页码、总页数与总数;Kotlin 侧读取 content、number、totalElements 组装响应,分页参数由 PageRequest 传入,避免一次性加载全量集合。
概念解释
Page 是分页结果包装,Pageable 携带页码、页大小与排序。Kotlin 扩展可简化响应映射,但分页元数据结构仍来自 Spring Data 类型。大结果集必须分页查询。
原理流程
- 构造
PageRequest.of(page, size, sort)。 - 仓库
findAll(spec, pageable)返回Page<T>。 - 读取内容与分页元数据。
- 映射为前端分页响应 DTO。
代码或图示
val page: Page<Order> = repository.findAll(PageRequest.of(0, 20, Sort.by("id")))
val result = PageResponse(content = page.content.map { it.toDto() }, total = page.totalElements)
常见误区
- 只取内容忽略总数:前端无法计算总页数。
- 页大小过大:单查询返回过多行,内存与 DB 压力上升。
追问
- 无总数查询怎么做?答:Slice/列表分页只翻页不取总数,通用分页机制见 05 分册。
- 分页排序字段必须存在于实体:否则排序解析失败。
06.8.2.3-018 Sort 在 Kotlin 仓库查询中如何书写?
一句话结论
Sort.by("property", Direction.DESC) 声明排序,属性名对应实体属性;多字段排序按链式顺序生效,动态排序需校验字段白名单,避免拼接非法属性。
概念解释
排序对象携带属性方向列表。Kotlin 构造 Sort 传入属性与方向;派生查询可在方法名写 OrderBy...,显式 Sort 更灵活。动态排序参数来自请求时要防字段注入。
原理流程
- 从请求解析排序字段与方向。
- 校验字段在允许白名单内。
- 构造 Sort 传入 Pageable。
- 查询 ORDER BY 按字段顺序生成。
代码或图示
val sort = Sort.by(Sort.Direction.DESC, "createdAt")
val pageable = PageRequest.of(page, size, sort)
常见误区
- 直接把请求字段名拼进 Sort:非法属性可能映射失败或注入风险。
- 多字段方向逐个写错:排序优先级不符预期。
追问
- 方法名排序与 Sort 参数冲突?答:以传入 Pageable 的 Sort 为准或按派生规则,通用查询见 05 分册。
- 关联属性排序?答:排序路径需 join 关联,注意查询计划。
06.8.2.3-019 AuditorAware 在 Kotlin 中如何实现创建人/更新人审计?
一句话结论
实现 AuditorAware<T> 接口提供当前审计人,Kotlin 方法返回 Optional<T>;配合实体审计字段注解,框架在插入/更新时自动填充操作人。
概念解释
审计人解析通常来自安全上下文。getCurrentAuditor 返回当前用户标识,框架在实体持久化前后写入 @CreatedBy/@LastModifiedBy 字段。Kotlin 实现接口方法,空用户返回空 Optional。
原理流程
- 实现 AuditorAware 读取安全上下文当前用户。
- 注册为 Bean 并开启审计注解。
- 实体标注创建/更新人字段。
- 持久化时框架回调填充审计字段。
代码或图示
class SpringSecurityAuditorAware : AuditorAware<String> {
override fun getCurrentAuditor(): Optional<String> {
val auth = SecurityContextHolder.getContext().authentication
return Optional.ofNullable(auth?.name)
}
}
常见误区
- 审计字段用
val:更新时无法回填最后修改人。 - 非 Web 线程读不到安全上下文:异步/调度任务需显式传递用户标识。
追问
- 时间审计字段?答:
@CreatedDate/@LastModifiedDate由 JPA 审计自动填充,通用审计机制见 05 分册。 - 无登录用户场景返回什么?答:空 Optional,字段保持 null 或系统默认值。
06.8.2.3-020 detached/managed 状态与 Kotlin 不可变设计有什么冲突?
一句话结论
受管实体在持久化上下文中被脏检查跟踪,detached 实例脱离上下文后修改不会自动落库;Kotlin 不可变 data class 副本天然 detached,不能直接当受管实体更新。
概念解释
JPA 实体生命周期分游离、受管、删除状态。只有受管状态的字段变更被 flush 跟踪。跨层传递的不可变副本 detached,更新需重新加载实体再改,或通过合并持久化。
原理流程
- 查询返回受管实体。
- 会话关闭后实例变为 detached。
- detached 实例修改不被跟踪。
- 更新场景重新加载受管实体,应用变更后保存。
代码或图示
// 错误:修改 detached 副本期望自动落库
val copy = entity.copy(name = "new")
// 正确:加载受管实体后修改
val managed = repository.findById(id).orElseThrow()
managed.name = "new"
常见误区
- 服务层返回实体引用给前端层修改:会话外状态不一致。
- 把 data class 副本 merge 后误以为原实体同步更新。
追问
- detached 实例如何重新关联?答:
merge或重新查询加载,通用实体状态机见 05 分册。 - 事务边界与会话范围?答:受管状态存活在事务/会话内,通用事务原理见 06.2。
06.8.2.3-021 data class 生成的 equals/hashCode 与 JPA 代理有何冲突?
一句话结论
data class 按构造器字段生成相等性,代理实体可能字段未初始化或关联未加载,导致两个同一行实体比较结果不稳定;实体相等性应基于主键/业务标识,不依赖完整字段快照。
概念解释
Hibernate 代理是子类实例,标识符字段可能已加载而其余字段延迟。结构相等性比较未初始化字段时结果不确定。集合中存放实体时 hashCode 不稳定会影响 Set/Map 行为。
原理流程
- 代理实体被加入集合。
- hashCode 按 data class 字段计算,字段状态影响结果。
- 字段加载前后 hashCode 变化,集合位置失效。
- 基于主键的相等性在代理与初始化状态下保持稳定。
代码或图示
// 实体:相等性按主键实现,不纳入关联与可变字段
@Entity
open class Account(@Id val id: Long) {
override fun equals(other: Any?): Boolean =
other is Account && other.id == id
override fun hashCode(): Int = id.hashCode()
}
常见误区
- 实体放进 HashSet 用 data class 相等性:懒加载后行为异常。
- 把关联集合纳入 equals:循环关联或未初始化导致比较开销与错误。
追问
- 主键在保存前为 null 怎么算相等?答:临时对象用业务标识或 UUID,通用实体相等性策略见 05 分册。
- DTO 可以用结构相等吗?答:可以,DTO 无代理与懒加载问题。
06.8.2.3-022 实体 toString 遍历关联导致栈溢出如何避免?
一句话结论
双向关联的 toString 互相引用会递归遍历直至栈溢出;实体字符串输出只包含基础标量字段,不输出关联集合与双向引用,调试日志避免直接打印实体。
概念解释
data class 自动生成的 toString 包含全部构造器字段,关联集合被展开,双向关联形成 A→B→A 递归。自定义 toString 限定标量字段,关联按需在日志中单独取标识。
原理流程
- 日志/调试输出实体。
- toString 遍历关联字段。
- 双向关联递归引用。
- 栈溢出或触发大量懒加载查询。
代码或图示
override fun toString(): String =
"Order(id=$id, status=$status, amount=$amount)" // 不含 items/customer
常见误区
- 依赖 data class 默认 toString 打印关联实体:递归 N+1 与栈溢出风险。
- 日志输出整个实体集合:逐条触发关联加载。
追问
- 调试需要关联信息怎么办?答:显式取关联 id 或构造视图字符串。
- 双向关联序列化前端?答:用 DTO 截断关联深度,避免序列化循环。
06.8.2.3-023 实体构建用构造器还是 Builder 模式?
一句话结论
简单实体用主构造器初始化必填字段;字段多、可选参数多的场景用 Companion Builder 或领域工厂方法封装校验与关联一致性,避免服务层直接堆砌可选参数。
概念解释
Kotlin 默认参数与命名参数替代部分 Builder 能力;复杂聚合根仍需要工厂方法保证不变量。实体构造与持久化回填分离:业务构造走工厂,框架实例化走无参构造。
原理流程
- 必填字段进主构造器。
- 可选字段给默认值或由工厂方法设置。
- 工厂方法校验业务规则并维护双向关联。
- 框架反射无参构造仅用于持久化。
代码或图示
@Entity
open class Order private constructor(
@Id val id: Long,
var status: OrderStatus,
) {
companion object {
fun create(id: Long, amount: BigDecimal): Order = Order(id, OrderStatus.PENDING)
}
}
常见误区
- 构造器暴露可变状态让外部直接拼装关联:不变量失守。
- 为框架回填把业务校验也写进无参构造:合成构造不执行该路径。
追问
- 私有构造器 noarg 还能生成吗?答:构造器可见性与插件生成规则需核对官方文档(待确认)。
- 领域事件在工厂方法触发?答:聚合根创建事件可在工厂内记录,通用领域建模见 11 分册。
06.8.2.3-024 @Embeddable 值对象在 Kotlin 中如何映射?
一句话结论
值对象用 data class/嵌入类标注 @Embeddable,实体字段以 @Embedded 引用;嵌入对象作为不可变值集合,字段映射到主表列,适合地址、金额等值类型。
概念解释
嵌入对象把一组列封装为值类型,不单独建表。Kotlin data class 适合值对象:相等性按字段、无代理状态问题。嵌入对象字段可空性随列约束表达。
原理流程
- 值类标注
@Embeddable,声明列字段。 - 实体字段标注
@Embedded。 - 嵌入对象字段映射到主表列。
- 查询/更新随实体一起持久化。
代码或图示
@Embeddable
data class Address(val city: String, val street: String, val zip: String)
@Entity
open class Shop(@Id val id: Long, @Embedded val address: Address)
常见误区
- 嵌入对象设计成可变实体:值对象应不可变,修改时整体替换。
- 嵌入字段可空与列可空性不一致:绑定结果异常。
追问
- 列名前缀怎么配?答:
@AttributeOverride覆盖嵌入字段列名,通用嵌入映射见 05 分册。 - 嵌入对象能被关联引用吗?答:值对象不做实体关联,需要关联时用独立实体。
06.8.2.3-025 Bean Validation 注解标注在 Kotlin 属性上要注意什么?
一句话结论
约束注解落点(字段/构造器参数/属性)需与访问策略一致;Kotlin 属性使用 @field: 前缀明确字段注解,校验在绑定/持久化前触发,可空类型与约束注解配合表达必填。
概念解释
JSR-303 注解可标在字段、getter 或构造器参数。Kotlin 属性语法下默认落点可能不符合预期,用 @field:/@get:/@param: 指定。非空类型本身表达必填,字符串长度、范围等用补充约束。
原理流程
- 属性标注约束并指定注解目标。
- 校验器在触发阶段读取约束。
- 违例收集为约束 violation。
- 绑定/服务层拦截非法数据。
代码或图示
data class CreateProductRequest(
@field:NotBlank val title: String,
@field:Min(1) val priceCents: Int,
)
常见误区
- 注解目标写错:校验器读不到约束,校验不生效。
- 可空类型又加
@NotBlank:语义重复,非空必填应由类型表达。
追问
- 实体字段也要加校验吗?答:入口 DTO 校验为主,实体不变量由领域方法保证;通用 Validation 见 06.1。
- 嵌套对象级联校验?答:字段加
@Valid触发嵌入对象约束。
06.8.2.3-026 懒加载关联在 Kotlin 中访问有哪些会话外风险?
一句话结论
懒加载关联仅在会话内首次访问初始化;会话关闭后访问触发懒加载异常或 detached 问题,Kotlin 可空集合/单值不代表关联已加载,应在事务内完成关联读取或用投影显式取数。
概念解释
代理关联在会话外解引用需要重新连接会话。Web 层序列化实体时会话已关闭,触发懒加载失败。避免在返回实体前遍历关联,查询阶段用 join fetch 或投影取需要的字段。
原理流程
- 事务/会话内加载实体。
- 关联保持代理未初始化。
- 会话关闭后访问代理。
- 抛懒加载异常或返回未初始化状态。
代码或图示
// 事务内需要关联时显式抓取;返回投影 DTO 避免会话外遍历
@Query("select o from Order o join fetch o.customer where o.id = :id")
fun findWithCustomer(id: Long): Order?
常见误区
- 控制器直接返回懒加载实体:序列化阶段会话外触发加载。
- 以为
var customer: Customer?判空就安全:null 判断不触发初始化,解引用才触发。
追问
- open session in view 要不要开?答:通用 OSIV 利弊见 05/06 分册;建议服务层准备好数据再返回。
- 关联批量加载防 N+1?答:join fetch/实体图批量抓取,通用 N+1 治理见 05 分册。
06.8.2.3-027 实体与 DTO 分离时 Kotlin 映射怎么组织?
一句话结论
实体保持持久化模型,DTO 用 data class 表达接口契约;映射函数放独立 mapper/扩展层,实体不暴露给 Web 层,避免关联泄露、字段污染与会话外懒加载问题。
概念解释
分层映射隔离持久化模型与 API 模型。Kotlin 扩展函数或 mapper 类负责双向转换:实体→DTO 用于响应,命令 DTO→实体用于写入。映射集中一处便于脱敏与字段裁剪。
原理流程
- 实体受管于仓库层。
- 服务层查询实体后调用映射转 DTO。
- 命令 DTO 校验后转领域/实体写入。
- Web 层只接触 DTO。
代码或图示
fun Order.toDto(): OrderDto = OrderDto(
id = id,
status = status.name,
amount = amount.toPlainString(),
)
常见误区
- DTO 直接嵌入实体返回:关联与内部字段暴露。
- 映射逻辑散落在控制器:复用差,脱敏规则不一致。
追问
- 映射用 MapStruct 还是手写?答:Kotlin 项目可手写扩展或注解处理器;通用映射方案见 03/06 分册。
- 双向映射放哪?答:同包 mapper 扩展,按领域分组。
06.8.2.3-028 Spring Data 审计字段如何在 Kotlin 实体上声明?
一句话结论
创建时间/更新时间/创建人/更新人标注审计注解,字段用 var(更新人/更新时间需回填);开启 JPA 审计后框架自动填充,Kotlin 实体提供对应可空或默认字段。
概念解释
审计字段由框架在插入/更新前后写入。创建类字段可只读视图,更新类字段必须可写。审计人与时间解析配合 AuditorAware 与时间戳生成器。
原理流程
- 实体标注
@CreatedDate/@LastModifiedDate/@CreatedBy/@LastModifiedBy。 - 开启审计配置。
- 插入时填充创建字段,更新时刷新更新字段。
- 业务代码不手动维护审计值。
代码或图示
@Entity
open class Article(
@Id @GeneratedValue val id: Long = 0,
var title: String,
@CreatedDate var createdAt: Instant? = null,
@LastModifiedDate var updatedAt: Instant? = null,
)
常见误区
- 更新审计字段写成
val:框架无法回填。 - 忘记开启审计注解:字段保持 null。
追问
- 审计人类型用 Long 还是 String?答:按用户标识体系选择,AuditorAware 泛型对应。
- 时区怎么存?答:用 Instant/UTC 存储,展示层转时区,通用时间处理见 01 分册。
06.8.2.3-029 自定义仓库片段在 Kotlin 中如何实现?
一句话结论
定义片段接口 + 实现类(命名约定为接口名 + Impl),Spring Data 把片段方法合并到仓库代理;Kotlin 实现类注入 EntityManager 或仓库依赖,编写自定义查询与更新逻辑。
概念解释
派生方法与 JPQL 表达不了的查询走自定义片段。片段接口声明方法,实现类提供逻辑,仓库主接口继承片段。代理把默认实现与片段实现拼接为最终仓库 Bean。
原理流程
- 定义片段接口
OrderRepositoryCustom。 - 实现类
OrderRepositoryCustomImpl注入 EntityManager。 - 主仓库接口继承片段接口。
- 启动期代理合并两部分方法。
代码或图示
interface OrderRepositoryCustom {
fun search(criteria: SearchCriteria): List<Order>
}
class OrderRepositoryCustomImpl(private val em: EntityManager) : OrderRepositoryCustom {
override fun search(criteria: SearchCriteria): List<Order> {
// 自定义 Criteria/原生查询实现
return emptyList()
}
}
常见误区
- 实现类命名不符约定:Spring Data 找不到片段实现。
- 片段实现里直接暴露 EntityManager 给服务层:仓库边界泄漏。
追问
- 片段实现能注入其他仓库吗?答:可以,但注意循环依赖;通用仓库扩展机制见 Spring Data 文档。
- 片段方法能加事务注解吗?答:事务边界建议放在服务层,仓库片段保持数据访问。
06.8.2.3-030 suspend 仓库方法与阻塞 JPA 共存有什么注意点?
一句话结论
阻塞 JPA 仓库方法不应直接挂到 WebFlux 事件循环;suspend 服务方法调用阻塞仓库需在 IO 隔离调度器执行,响应式数据访问则用对应非阻塞仓库,事务边界与线程隔离要一并验证。
概念解释
JPA/Hibernate 默认阻塞 JDBC 访问。协程服务调用阻塞仓库时,调用线程被数据库等待占用;隔离到 IO 池避免事件循环阻塞。响应式栈(R2DBC)才有非阻塞仓库与响应式事务,二者不要混。
原理流程
- 服务接口声明 suspend 方法。
- 阻塞仓库调用经
withContext(IO)隔离。 - 事务在隔离线程边界内开启提交。
- 验证事务上下文跨调度切换行为(待确认实现支持)。
代码或图示
@Service
class OrderQueryService(private val repository: OrderRepository) {
suspend fun find(id: Long): Order? = withContext(Dispatchers.IO) {
repository.findById(id).orElse(null)
}
}
常见误区
- WebFlux 控制器直接注入阻塞 JPA 仓库:事件循环被 JDBC 阻塞。
- suspend 事务方法内并发 async 共享阻塞事务:连接与上下文行为未验证。
追问
- 响应式仓库用什么技术?答:R2DBC + Spring Data R2DBC,通用数据访问选型见 05 分册。
- 阻塞方法包成 suspend 就算非阻塞吗?答:不是,只是线程隔离,仍占工作线程。
06.8.2.3-031 多数据源在 Kotlin 配置类中如何组织?
一句话结论
每个数据源一套 DataSource、事务管理器与仓库扫描配置,Kotlin 配置类用 @Bean 定义独立 Bean 并通过限定符区分;仓库包路径按数据源隔离,避免候选歧义。
概念解释
多数据源需要各自连接池与事务管理器,仓库按包/限定符绑定数据源。配置类显式定义 Bean,@Qualifier 区分同名类型;Kotlin 构造器注入配合限定符选择目标数据源。
原理流程
- 为每个数据源定义 DataSource Bean。
- 配套事务管理器与实体管理器工厂。
- 仓库扫描按包绑定对应工厂。
- 服务层按限定符注入目标仓库。
代码或图示
@Configuration
open class DataSourceConfig {
@Bean @Qualifier("main")
open fun mainDataSource(): DataSource = /* ... */
@Bean @Qualifier("report")
open fun reportDataSource(): DataSource = /* ... */
}
常见误区
- 两个数据源仓库同包扫描:实体管理器工厂绑定错数据源。
- 事务管理器未区分:跨数据源事务边界混乱。
追问
- 跨数据源分布式事务?答:属于分布式事务范畴,见 09 分册;本地事务各自独立。
- 配置属性按前缀绑定?答:两套
@ConfigurationProperties分别读取数据源配置。
06.8.2.3-032 原生 SQL 查询结果如何映射到 data class?
一句话结论
原生查询按列别名匹配构造器参数或接口投影;data class 构造器参数名/别名与 SQL 别名对应,可通过 @ConstructorResult/结果映射声明列到属性映射,避免依赖反射猜名字。
概念解释
原生 SQL 绕过 JPQL 实体模型,结果行映射需要显式约定。构造器投影按别名匹配参数,复杂映射用结果映射注解。Kotlin data class 作为只读结果载体接收映射行。
原理流程
- 编写原生 SQL 并给列别名。
- 定义结果 data class 或投影接口。
- 声明构造器/结果映射绑定列。
- 查询返回映射后的不可变对象。
代码或图示
data class SalesRow(val category: String, val total: BigDecimal)
@Query(
value = "select category, sum(amount) as total from sales group by category",
nativeQuery = true,
)
fun salesByCategory(): List<SalesRow>
常见误区
- 别名与参数名大小写/下划线不一致:映射失败或字段为 null。
- 原生 SQL 拼接动态条件:注入风险,应使用参数绑定。
追问
- 结果映射注解在 Kotlin 构造器上怎么标?答:按 JPA 结果映射规则标注构造器参数,通用原生查询见 05 分册。
- 单列结果映射?答:直接返回标量类型集合。
06.8.2.3-033 乐观锁版本字段 @Version 与不可变属性如何协调?
一句话结论
@Version 字段用于乐观锁,更新时由框架自增,因此字段必须可写(var);它不是业务不可变字段,即使对业务只读,持久化层仍需要写入入口。
概念解释
版本号在每次更新时递增,提交时与读取版本比对。框架回填版本字段要求可写访问。val 无法被框架更新,会导致版本递增失败。业务层不直接修改版本字段。
原理流程
- 实体声明
@Version var version: Long?。 - 读取实体时携带版本号。
- 更新提交时版本 +1 并比对。
- 版本不匹配抛乐观锁冲突异常。
代码或图示
@Entity
open class Product(
@Id val id: Long,
var title: String,
@Version var version: Long? = null,
)
常见误区
- 版本字段写成
val:框架无法递增,乐观锁失效。 - 业务代码手动改版本号:破坏冲突检测语义。
追问
- 版本冲突如何处理?答:重试或返回冲突状态码,通用并发控制见 09 分册。
- 版本字段可以是时间戳吗?答:支持时间戳版本类型,但数值版本更常用。
06.8.2.3-034 实体构造生成策略与 noarg 插件的执行顺序是什么?
一句话结论
noarg 在编译期为实体类生成无参构造,主键生成策略在运行期由框架分配;两者阶段不同:编译器产物先就绪,运行时实体实例化后框架按生成策略填主键。
概念解释
无参构造是编译产物,@GeneratedValue 是运行期主键填充。Kotlin 实体字段可给默认值(如 0/null)作为框架回填前占位,生成策略决定主键来源(自增、序列、UUID)。
原理流程
- 编译期 noarg 合成无参构造。
- 运行期框架无参构造实例化。
- 主键生成策略分配标识。
- 其余字段按结果/入参回填。
代码或图示
@Entity
open class Article(
@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
val id: Long = 0,
var title: String,
)
常见误区
- 以为编译期生成主键:主键在持久化时分配。
- 无参构造合成失败影响主键生成:先解决构造器问题再谈策略。
追问
- UUID 主键默认值?答:可在实体工厂生成 UUID,或用生成策略;通用主键策略见 05 分册。
- 复合主键怎么映射?答:嵌入主键类或
@IdClass, Kotlin 实现按 JPA 规则。
06.8.2.3-035 启动或持久化阶段常见实体报错如何定位?
一句话结论
常见报错分三类:无参构造缺失、类/方法 final 无法代理、映射属性/列不匹配;按异常栈定位到实体类,反编译核对构造与 final 标志,再核对属性名与列映射注解。
概念解释
启动期解析实体元数据,映射与构造问题早期暴露;运行期报错集中在懒加载、脏检查与关联回填。先分清是元数据启动错误还是会话内持久化错误,再对应排查路径。
原理流程
- 启动异常:查实体构造、final、映射注解。
- 反编译确认 noarg/allopen 产物。
- 运行期异常:检查会话范围、关联加载、版本字段。
- 修复后重启验证元数据解析。
代码或图示
排查链:异常类名 -> 实体注解 -> 构造器/final 标志 -> 属性名/列映射 -> 会话状态
常见误区
- 看到持久化异常就改 SQL:根因可能是实体构造或代理问题。
- 忽略启动期告警:元数据问题在首次查询时集中爆发。
追问
- 如何打开 JPA 绑定/ SQL 日志?答:按持久化提供商配置日志级别,通用数据访问调试见 05 分册。
- 实体代理失败与 AOP 代理失败区别?答:前者 Hibernate 子类化,后者 Spring AOP;分别核对 allopen 配置。
06.8.2.3-036 Spring Security 的 Kotlin 配置 DSL 定位是什么?
一句话结论
Security Kotlin DSL 以 http { } 链式块替代 Java 链式 HttpSecurity 调用,在 Kotlin 配置类中声明授权、登录、过滤器等规则;产出仍是标准 SecurityFilterChain Bean,通用安全模型不变。
概念解释
DSL 只是配置表达方式,底层注册的过滤器链与 Java 配置等价。Kotlin DSL 利用 lambda 接收者减少链式嵌套,规则按块组织;Security 通用过滤器链、认证授权原理见 06.2,本节只写 Kotlin 写法。
原理流程
- 配置类声明
SecurityFilterChainBean。 http { }块内按 DSL 声明各安全规则。- DSL 转换为 HttpSecurity 配置。
- 容器注册过滤器链 Bean 接入请求链路。
代码或图示
@Bean
open fun filterChain(http: HttpSecurity): SecurityFilterChain {
http {
authorizeHttpRequests {
authorize(anyRequest, authenticated)
}
}
return http.build()
}
常见误区
- 以为 DSL 有独立安全语义:它只包装 Spring Security 配置,过滤器行为与 Java 配置一致。
- DSL 块内混用 Java 链式调用:风格混杂但可工作,项目内应统一一种写法。
追问
- DSL 来自哪个依赖?答:spring-security-config 的 Kotlin 扩展,随 Security starter 引入。
- DSL 与 Spring Security 6 配置基线?答:6.x 推荐
SecurityFilterChainBean 方式,旧式 WebSecurityConfigurerAdapter 已移除;版本细节以官方文档为准(待确认)。
06.8.2.3-037 http { } 配置块的结构是怎样的?
一句话结论
http { } 接收者提供各配置子块:authorizeHttpRequests、formLogin、csrf、cors、sessionManagement 等,每个子块内声明对应规则,块之间顺序表达过滤器配置层次。
概念解释
DSL 子块对应 HttpSecurity 各定制器。请求授权、登录方式、CSRF/CORS、会话策略、异常入口分别在独立块内配置,结构清晰对应安全职责。块内谓词与规则按 Security 语义求值。
原理流程
- 进入
http接收者作用域。 - 调用各配置子块方法。
- 子块 lambda 内填写规则。
- 构建时组装过滤器链。
代码或图示
http {
authorizeHttpRequests { authorize(anyRequest, authenticated) }
formLogin { }
csrf { disable() }
cors { }
sessionManagement { sessionCreationPolicy(STATELESS) }
}
常见误区
- 子块嵌套层级写错:配置未作用到预期定制器。
- 在
http块外写授权规则:过滤器链未拿到规则配置。
追问
- 各子块与过滤器顺序关系?答:过滤器顺序由 Security 内部约定,通用链原理见 06.2。
- 一个应用能有多个
http块吗?答:多个过滤器链 Bean 分别配置,见多链条目。
06.8.2.3-038 authorizeHttpRequests { } 规则链如何书写?
一句话结论
块内用 authorize(请求匹配器, 权限规则) 逐条声明,规则按声明顺序匹配,先命中先生效;通配兜底规则放最后,精确路径规则前置。
概念解释
授权规则是「匹配器 → 访问策略」列表。DSL 中匹配器与策略作为参数传入 authorize。顺序敏感:宽泛规则在前会覆盖后续精确规则,与 Web 路由顺序同理。
原理流程
- 块内声明各路径访问规则。
- 请求到达按顺序匹配规则。
- 首个匹配规则决定授权策略。
- 无匹配走兜底策略。
代码或图示
authorizeHttpRequests {
authorize("/public/**", permitAll)
authorize("/admin/**", hasRole("ADMIN"))
authorize(anyRequest, authenticated)
}
常见误区
anyRequest写在前面:后续精确规则全部失效。- 规则顺序与预期相反:宽松路径意外放行。
追问
- 规则匹配器有哪些类型?答:路径模式、方法、媒体类型等,通用请求匹配见 06.2。
- 未匹配默认策略?答:由兜底规则决定,未配置通常拒绝访问。
06.8.2.3-039 路径匹配在 Kotlin DSL 中如何声明?
一句话结论
用 pathPatterns("/api/**") 声明路径匹配器(6.x 推荐路径模式),与 HTTP 方法组合;ant 风格匹配器为兼容旧语法,新项目优先 pathPatterns。
概念解释
匹配器定义哪些 URL 进入该授权规则。路径模式支持 ** 通配与路径变量;方法匹配可限定 GET/POST。DSL 匹配器方法返回请求匹配器对象,传入 authorize。
原理流程
- 构造路径/方法匹配器。
- 与访问策略组成规则。
- 请求路径与方法逐条匹配。
- 命中规则执行策略判断。
代码或图示
authorizeHttpRequests {
authorize(pathPatterns("/users/**"), hasAuthority("USER_READ"))
authorize(HttpMethod.POST, pathPatterns("/orders"), authenticated)
}
常见误区
- 混用 ant 与 pathPattern 语法:通配语义不同,匹配结果不符预期。
- 路径变量写死在规则里:应按模式匹配,具体值在控制器内校验。
追问
- 6.x 为什么推荐 pathPatterns?答:统一路径模式解析,AntPathMatcher 处于兼容地位;通用匹配机制见 06.2。
- 静态资源如何放行?答:对资源路径模式 permitAll。
06.8.2.3-040 permitAll、hasRole、hasAuthority 在 DSL 中如何用?
一句话结论
permitAll 放行,hasAuthority("SCOPE") 判断细粒度权限,hasRole("ADMIN") 判断角色并自动补 ROLE_ 前缀;按授权模型选择角色还是权限粒度。
概念解释
访问策略表达式对应 Security 授权能力。角色是权限的封装约定,hasRole 自动加前缀;细粒度接口/资源权限用 authority。DSL 中策略作为常量/表达式传入规则。
原理流程
- 规则匹配到请求。
- 从认证主体取权限/角色集合。
- 策略判断集合是否包含要求项。
- 通过则放行,否则进入拒绝/未认证流程。
代码或图示
authorizeHttpRequests {
authorize("/health", permitAll)
authorize("/reports/**", hasRole("ANALYST"))
authorize("/orders/**", hasAuthority("ORDER_WRITE"))
}
常见误区
hasRole再手写ROLE_前缀:重复前缀导致匹配失败。- 角色与权限概念混用:授权模型混乱,前后端拿到的标识不一致。
追问
- 多个权限如何组合?答:
hasAnyRole/hasAnyAuthority或表达式 and/or,通用表达式见 06.2。 - 自定义权限字符串从哪来?答:UserDetails 加载的 authorities 集合。
06.8.2.3-041 表单登录在 Kotlin DSL 中如何配置?
一句话结论
formLogin { } 块配置登录页、登录处理路径、默认成功路径等;前后端分离的 API 服务通常不启用表单登录,改用无状态认证(JWT/Token)。
概念解释
表单登录是 Security 内置用户名密码流程。DSL 块可定制登录页面 URL、参数名、成功/失败处理。纯 JSON API 场景关闭表单登录,由自定义过滤器或资源服务器处理认证。
原理流程
formLogin定制器启用表单认证。- 登录提交路径由过滤器接收。
- 认证成功建立会话/重定向,失败返回登录页。
- API 场景在 DSL 中禁用表单登录。
代码或图示
formLogin {
loginPage = "/login"
defaultSuccessUrl("/home", true)
}
常见误区
- API 服务保留表单登录默认页:出现重定向与会话 cookie 预期外行为。
- 登录参数名与前端提交不一致:认证过滤器读不到用户名密码。
追问
- 登录成功返回 JSON 怎么配?答:自定义成功处理器,通用认证流程见 06.2。
- 表单登录与会话策略配套?答:表单登录通常依赖会话,无状态 API 不搭配。
06.8.2.3-042 密码编码器 Bean 如何在 Kotlin 配置中声明?
一句话结论
密码编码器注册为 PasswordEncoder Bean(常用 BCryptPasswordEncoder),认证服务用它比对/编码密码;Kotlin 配置类 @Bean 返回编码器实例,强度参数按安全要求设置。
概念解释
密码不存明文,编码器做单向哈希与盐值。UserDetailsService 加载用户后由过滤器用编码器匹配。Bean 被认证组件注入,配置集中在安全配置类。
原理流程
- 声明
PasswordEncoderBean。 - 注册用户时用编码器编码原始密码。
- 登录时编码器比对提交密码与哈希。
- 匹配成功建立认证。
代码或图示
@Bean
open fun passwordEncoder(): PasswordEncoder = BCryptPasswordEncoder(12)
常见误区
- 用明文比对或弱哈希:安全风险。
- 编码器强度过低或过高:过低易破解,过高增加登录耗时。
追问
- 强度因子含义?答:BCrypt 轮数,越高越慢越安全,取值按性能与安全平衡;通用密码策略见 06.1。
- 密码升级哈希?答:可在登录时检测弱编码并升级,属于认证增强方案。
06.8.2.3-043 自定义 UserDetailsService 在 Kotlin 中怎么实现?
一句话结论
实现 loadUserByUsername 返回 Spring UserDetails(用户名、密码哈希、权限集合);Kotlin 类实现接口方法,从仓库/用户表加载用户,权限映射为 SimpleGrantedAuthority。
概念解释
UserDetailsService 是认证用户加载端口。实现类被 DaoAuthenticationProvider 调用,返回主体与权限;密码哈希与角色权限在此装配。找不到用户抛 UsernameNotFoundException。
原理流程
- 认证过滤器提交用户名密码。
- 调用 UserDetailsService 加载主体。
- 组装权限集合。
- 密码由编码器比对。
代码或图示
class AppUserDetailsService(private val userRepository: UserRepository) : UserDetailsService {
override fun loadUserByUsername(username: String): UserDetails {
val user = userRepository.findByLogin(username)
?: throw UsernameNotFoundException("user not found")
return User.withUsername(user.login)
.password(user.passwordHash)
.authorities(user.roles.map { SimpleGrantedAuthority("ROLE_$it") })
.build()
}
}
常见误区
- 权限漏加前缀或角色重复前缀:
hasRole判断失败。 - 把明文密码放进 UserDetails:应存哈希,编码器比对。
追问
- 用户状态(锁定/过期)怎么表达?答:UserDetails 的 enabled/locked 等标志位,通用认证模型见 06.2。
- 自定义认证主体能携带扩展字段吗?答:实现 UserDetails 扩展自定义字段,认证后从上下文取出。
06.8.2.3-044 JWT 或自定义认证过滤器如何插入 DSL 过滤器链?
一句话结论
自定义过滤器实现认证逻辑,通过 addFilterBefore/addFilterAfter 或 addFilterAt 插入指定过滤器位置;DSL 中注册过滤器 Bean 实例,过滤器解析 Token 并设置 SecurityContext。
概念解释
JWT 等无状态认证用自定义过滤器在授权前解析令牌、加载主体。插入位置决定过滤器链顺序;过滤器不写响应,失败交给异常入口处理。通用过滤器链原理见 06.2,此处只看 Kotlin 接入。
原理流程
- 编写过滤器实现
OncePerRequestFilter。 - 解析请求头 Token,校验并加载主体。
- 设置 SecurityContext 认证。
- DSL 把过滤器插到指定位置。
代码或图示
@Bean
open fun filterChain(http: HttpSecurity, jwtFilter: JwtAuthFilter): SecurityFilterChain {
http {
addFilterBefore<UsernamePasswordAuthenticationFilter>(jwtFilter)
authorizeHttpRequests { authorize(anyRequest, authenticated) }
}
return http.build()
}
常见误区
- 过滤器插入位置错误:在授权之后才认证,规则判断时无主体。
- 过滤器内直接写错误响应:应抛认证异常,由入口统一处理。
追问
- Token 校验失败走哪个入口?答:authenticationEntryPoint 返回 401,见异常入口条目。
- 过滤器需要注入依赖吗?答:声明为 Bean 后由容器注入,再插入链中。
06.8.2.3-045 会话策略在 DSL 中如何配置?
一句话结论
sessionManagement { sessionCreationPolicy(...) } 设置会话创建策略:有状态表单登录用默认 IF_REQUIRED,纯 Token API 用 STATELESS,不创建 HttpSession。
概念解释
会话策略决定 Security 是否使用 HTTP Session 保存认证。无状态令牌认证选 STATELESS,避免会话创建与 Cookie;表单/服务器会话认证保留会话策略。策略与认证方式必须匹配。
原理流程
- 根据认证方式确定会话需求。
- DSL 设置策略枚举。
- 过滤器按策略决定是否创建/读取会话。
- 无状态方案每次请求独立校验令牌。
代码或图示
sessionManagement {
sessionCreationPolicy(SessionCreationPolicy.STATELESS)
}
常见误区
- JWT 服务仍启用会话:意外创建会话、会话固定风险。
- 表单登录配 STATELESS:登录状态无法保持。
追问
- 会话固定防护?答:Security 内置会话固定保护配置,通用会话机制见 06.2。
- 并发登录控制?答:会话管理配置最大会话数与过期策略。
06.8.2.3-046 CORS 在 Security DSL 中如何配置?
一句话结论
cors { } 块启用 CORS 支持,配置来源、方法、头、凭证等;可提供 CorsConfigurationSource Bean 统一规则,Security CORS 过滤器在授权前处理跨域预检。
概念解释
跨域配置允许浏览器跨端口/域名访问 API。Security 的 CORS 过滤器依赖配置源规则;预检 OPTIONS 请求由 CORS 过滤器处理,不进入业务授权。
原理流程
- 定义 CORS 配置源 Bean(来源、方法、头、有效期)。
- DSL
cors启用过滤器并引用配置源。 - 预检请求匹配规则返回 CORS 头。
- 实际请求携带凭证按规则放行。
代码或图示
@Bean
open fun corsConfigurationSource(): CorsConfigurationSource {
val config = CorsConfiguration().apply {
allowedOrigins = listOf("https://app.example.com")
allowedMethods = listOf("GET", "POST")
allowCredentials = true
}
return UrlBasedCorsConfigurationSource("/**").apply { registerCorsConfiguration("/**", config) }
}
常见误区
- 只在 Spring MVC 配 CORS 而 Security 链未启用:预检被安全链拦截。
- 来源用
*又允许凭证:规范不允许组合,浏览器拒绝。
追问
- 凭证与来源通配?答:allowCredentials 为 true 时必须显式来源列表。
- 自定义头放行?答:
allowedHeaders配置允许的请求头。
06.8.2.3-047 CSRF 在 API 场景如何开关?
一句话结论
表单/会话页面需要 CSRF 防护;纯无状态 Token API(每次请求带 Bearer Token)通常禁用 CSRF,DSL csrf { disable() };是否关闭按会话认证方式判断,不能图省事一律关闭。
概念解释
CSRF 防护针对 Cookie 会话自动携带的场景。无状态 Token 不依赖 Cookie 自动提交,不存在跨站伪造携带凭证;用 Cookie 会话的服务必须保留 CSRF 防护。
原理流程
- 判断认证凭证是否自动由浏览器携带。
- 会话 Cookie 认证:保留 CSRF 过滤器与令牌。
- Bearer Token API:可禁用 CSRF。
- 禁用后不得再依赖 Cookie 会话认证。
代码或图示
csrf { disable() } // 无状态 Token API
常见误区
- 全站禁用 CSRF 后仍用 Cookie 登录:跨站请求伪造风险。
- 前后端分离不了解 CSRF 令牌提交方式:表单提交被 403 拦截。
追问
- CSRF 令牌怎么返回前端?答:Cookie/响应头传递,表单/请求头携带,通用防护见 06.1。
- 哪些路径可豁免 CSRF?答:按配置放行特定端点,但需确认无会话凭证风险。
06.8.2.3-048 未认证/拒绝访问的异常入口如何配置?
一句话结论
exceptionHandling { } 配置 authenticationEntryPoint(未认证返回 401)与 accessDeniedHandler(已认证无权限返回 403);API 场景返回 JSON 错误而非重定向登录页。
概念解释
过滤器链在认证/授权失败时调用入口处理器。表单场景重定向登录页,API 场景由入口写出标准错误响应。两个处理器分别处理未登录与权限不足。
原理流程
- 请求无认证主体访问受保护资源。
- 调用入口返回 401。
- 有主体但权限不足。
- 调用拒绝处理器返回 403。
代码或图示
exceptionHandling {
authenticationEntryPoint = RestAuthenticationEntryPoint()
accessDeniedHandler = RestAccessDeniedHandler()
}
常见误区
- API 服务用默认重定向入口:返回 302 到登录页,前端无法解析。
- 401 与 403 混用:语义不清,客户端无法区分未登录与无权限。
追问
- 处理器如何返回 JSON?答:实现接口写响应体与状态码,复用全局错误模型。
- 入口处理器能抛异常给全局处理吗?答:Security 链内异常由对应处理器接管,通用异常处理见 06.1。
06.8.2.3-049 方法级安全在 Kotlin 中如何开启与使用?
一句话结论
开启方法级安全后,在服务方法上标注 @PreAuthorize 等注解,表达式基于认证主体判断权限;Kotlin 方法注解写法与 Java 一致,表达式字符串引用权限与参数。
概念解释
URL 规则控制到路径,方法级安全控制到服务方法。注解表达式可引用方法参数、权限集合;方法调用经 AOP 代理拦截判断。通用方法安全原理见 06.2,此处关注 Kotlin 接入。
原理流程
- 配置类开启方法级安全注解。
- 服务方法标注
@PreAuthorize。 - 代理在方法调用前求值表达式。
- 不通过抛访问拒绝异常。
代码或图示
@PreAuthorize("hasRole('ADMIN') or #order.ownerId == authentication.principal.id")
open fun approve(order: Order) { /* ... */ }
常见误区
- 被增强方法是 private/final:代理拦截不到,注解不生效(通用 AOP 约束见 06.2)。
- 表达式引用参数名但编译未保留参数名:解析失败。
追问
@PostAuthorize与@PreAuthorize区别?答:前者方法执行后校验返回值,后者执行前校验。- 方法安全在 Kotlin 接口还是实现上标注?答:标注在被代理调用的方法上,注解位置按代理策略确定。
06.8.2.3-050 安全表达式字符串与 Kotlin 代码如何配合?
一句话结论
@PreAuthorize 表达式是 SpEL 字符串,引用参数名与主体;Kotlin 侧保证参数名保留、主体类型明确,复杂权限判断可抽到自定义方法或服务层断言,避免表达式膨胀。
概念解释
表达式在代理层求值,访问方法参数与认证主体。字符串内不能直接调用 Kotlin 业务函数;复杂规则用自定义权限 Bean 引用,或在服务入口做显式权限检查。
原理流程
- 注解表达式声明条件。
- 代理求值时绑定参数与主体上下文。
- 引用参数名匹配 Kotlin 方法参数。
- 结果决定放行/拒绝。
代码或图示
@PreAuthorize("@permissionChecker.canEdit(#article, authentication)")
open fun edit(article: Article) { /* ... */ }
常见误区
- 表达式里写 Kotlin lambda/集合操作:SpEL 不支持 Kotlin 语法。
- 参数名被混淆裁剪:表达式引用不到参数。
追问
- 自定义 Bean 在表达式中引用?答:按 Bean 名引用
@beanName.method(...),通用 SpEL 见 06.2。 - 复杂权限放哪里更可测?答:抽权限服务方法,单测覆盖规则,表达式只做入口调用。
06.8.2.3-051 角色前缀 ROLE_ 约定在 Kotlin 项目中如何避免混淆?
一句话结论
hasRole 自动补 ROLE_ 前缀,authorities 集合中角色存储带前缀标识;Kotlin 常量统一管理角色名,避免一处手写前缀、一处省略导致匹配失败。
概念解释
角色与 authority 是两套命名:角色默认带 ROLE_ 前缀,hasRole 比较时补齐。加载用户权限时按约定放前缀,判断时用对应方法,常量集中定义避免散落字符串。
原理流程
- 定义角色常量(无前缀业务名)。
- 加载 authorities 时按规则加
ROLE_。 hasRole比较自动补前缀。- authority 判断用完整权限字符串。
代码或图示
object Roles {
const val ADMIN = "ADMIN"
}
// authorities = ["ROLE_$ADMIN"];判断 hasRole(Roles.ADMIN)
常见误区
- authority 里存
ROLE_ADMIN又用hasAuthority("ROLE_ADMIN")与hasRole混用:匹配口径不一。 - 角色字符串散落在注解与加载逻辑:改名时漏改。
追问
- 前后端角色标识一致吗?答:统一后端 authority 输出约定,前端按标识展示。
- 权限与角色层级?答:角色聚合权限,授权模型设计见 06.1。
06.8.2.3-052 自定义过滤器插入顺序如何选择?
一句话结论
按认证、授权、CORS、CSRF 等职责确定插入位置:认证过滤器在授权之前,addFilterBefore/After/At 参照现有过滤器类型;顺序错误会导致认证未建立就进入授权判断。
概念解释
过滤器链有固定职责顺序。自定义 JWT 认证需在用户名密码过滤器附近、授权拦截之前;CORS 在最前处理预检。参照 Security 过滤器顺序表选择锚点过滤器。
原理流程
- 明确自定义过滤器职责(认证/日志/改写)。
- 在顺序表中找锚点过滤器。
- DSL 指定 before/after/at 插入。
- 启动链验证各过滤器执行顺序。
代码或图示
addFilterBefore<UsernamePasswordAuthenticationFilter>(jwtFilter)
常见误区
- 过滤器插在授权之后:规则判断时主体为空。
- 多个自定义过滤器相对顺序未定义:行为依赖注册顺序,不稳定。
追问
- 如何查看过滤器链顺序?答:Actuator 映射/调试日志列出链中过滤器,通用排查见 06.2。
- 过滤器能替代现有认证过滤器吗?答:可在对应位置替换,注意禁用默认过滤器。
06.8.2.3-053 SecurityContext 在协程/响应式下如何传递?
一句话结论
传统 SecurityContext 基于 ThreadLocal,响应式/协程跨线程后不可靠;WebFlux 有响应式安全上下文适配,协程链路应把主体标识放入可传播上下文元素,不能依赖线程局部持有。
概念解释
Servlet 模型 SecurityContextHolder 用 ThreadLocal;响应式模型上下文随订阅传播。协程换线程恢复时 ThreadLocal 不跟随,自定义认证信息应走 CoroutineContext/响应式 Context 桥接。通用安全上下文原理见 06.2。
原理流程
- 过滤器建立认证主体。
- Servlet 模型存入 ThreadLocal 上下文。
- 响应式模型存入响应式上下文。
- 协程侧经桥接读取或转为上下文元素传播。
代码或图示
// 不要在协程中依赖 SecurityContextHolder.getContext() 跨线程保留
// 主体标识作为上下文元素显式传递
常见误区
- 在 suspend 服务方法里读 ThreadLocal 安全上下文:跨线程丢失。
- 响应式服务复用 Servlet 上下文工具类:读取不到主体。
追问
- WebFlux 安全上下文怎么读?答:响应式安全适配提供的上下文访问方式,见 Security 响应式文档(待确认版本 API)。
- 同步服务层如何拿当前用户?答:方法参数传入用户标识,而非静态上下文查找。
06.8.2.3-054 Kotlin 安全配置类与 SecurityFilterChain Bean 怎么写?
一句话结论
配置类声明 @Bean 返回 SecurityFilterChain,方法参数注入 HttpSecurity;配置类本身需可被代理增强(纳入 allopen 或显式 open),DSL 块内完成链配置后 http.build() 返回。
概念解释
6.x 安全配置以过滤器链 Bean 为核心。Kotlin 配置类方法接收 HttpSecurity 参数,DSL 配置后构建链返回 Bean。配置代理需求与普通 Spring 配置类一致,注意类/方法开放。
原理流程
- 配置类标注
@Configuration。 @Bean方法接收 HttpSecurity。- DSL 块定制规则。
build()产出 SecurityFilterChain 注册容器。
代码或图示
@Configuration
open class SecurityConfig {
@Bean
open fun filterChain(http: HttpSecurity): SecurityFilterChain {
http { authorizeHttpRequests { authorize(anyRequest, authenticated) } }
return http.build()
}
}
常见误区
- 配置类 final 未开放:配置代理失效,Bean 互调行为退化(见 06.8.2.1)。
- 忘记
return http.build():过滤器链未产出 Bean。
追问
- 多个过滤器链 Bean 如何区分?答:按顺序与请求匹配规则划分,见多链条目。
- 配置类能注入 UserDetailsService 吗?答:可作为方法参数或构造器注入。
06.8.2.3-055 多个 SecurityFilterChain 如何按顺序配置?
一句话结论
声明多个 SecurityFilterChain Bean,用顺序值或 @Order 排序,各链匹配不同请求范围;靠前的链先匹配,兜底链处理其余请求,避免规则互相覆盖。
概念解释
不同路径前缀可挂不同安全策略(管理后台、开放 API、资源服务器)。每条链有独立匹配器与规则,按顺序尝试。链顺序与规则范围必须显式规划。
原理流程
- 为每类请求定义链 Bean。
- 设置链顺序与请求匹配器。
- 请求按顺序匹配首个适用链。
- 链内规则接管认证授权。
代码或图示
@Bean @Order(1)
open fun adminChain(http: HttpSecurity): SecurityFilterChain { /* 匹配 /admin/** */ }
@Bean @Order(2)
open fun apiChain(http: HttpSecurity): SecurityFilterChain { /* 其余 API */ }
常见误区
- 兜底链排在前面:专用链永远不生效。
- 链之间匹配范围重叠:请求落到先声明的链,规则非预期。
追问
- 链匹配器怎么声明?答:
securityMatcher(...)指定该链适用路径,通用多链机制见 06.2。 - 多链共享编码器/用户服务?答:公共组件单独 Bean 注入各链。
06.8.2.3-056 注销配置在 DSL 中如何书写?
一句话结论
logout { } 块配置注销路径、成功处理器与清除策略;无状态 Token 场景注销由前端清除令牌,后端可选提供吊销端点,不依赖服务端会话清除。
概念解释
表单会话认证的注销由 Security 过滤器处理:清除会话、删除 Cookie、跳转成功页。Token 无状态方案没有服务端会话可清,注销本质是客户端丢弃令牌;黑名单/吊销属额外设计。
原理流程
- 会话方案:配置注销路径与清除行为。
- 注销请求到达清除认证会话。
- 无状态方案:前端删除 Token。
- 必要时后端维护吊销名单。
代码或图示
logout {
logoutPath = "/logout"
logoutSuccessUrl = "/login?logout"
}
常见误区
- JWT 服务依赖服务端注销会话:无状态下服务端无状态可清,令牌在过期前仍有效。
- 注销端点未放行:未认证/已认证边界配置错误导致 401。
追问
- Token 吊销怎么做?答:短期 Token + 刷新令牌吊销名单,通用认证设计见 06.1/09 分册。
- 注销成功返回 JSON?答:自定义 logoutSuccessHandler。
06.8.2.3-057 记住我功能在 DSL 中如何配置?
一句话结论
rememberMe { } 配置持久化记住令牌;表单会话场景使用,无状态 API 通常不需要。启用需配套令牌存储与密钥,Kotlin 配置块声明数据源/键与过期时间。
概念解释
记住我在会话失效后凭持久化令牌恢复登录。依赖令牌存储(数据库/令牌库)与签名密钥;安全性要求高于普通会话,应评估是否开放。API Token 方案用刷新令牌替代该机制。
原理流程
- 登录勾选记住我,生成持久化令牌。
- 令牌存储并绑定用户。
- 会话过期后凭令牌恢复认证。
- 令牌失效/轮换策略配套。
代码或图示
rememberMe {
key = "change-me-secret"
tokenValiditySeconds = 1209600
}
常见误区
- 硬编码记住我密钥进源码:应放外部配置。
- 无状态 API 启用记住我:机制与令牌模型不匹配。
追问
- 持久化令牌存哪里?答:TokenRepository 配套 JDBC 存储,通用会话机制见 06.2。
- 记住我令牌泄露风险?答:长有效期需轮换与失效策略,安全设计见 06.1。
06.8.2.3-058 BCrypt 密码强度如何选择?
一句话结论
强度因子决定哈希计算轮数,在登录耗时与抗暴力破解之间权衡;生产环境选当前推荐因子(具体数值随硬件演进,以安全基线为准,待确认),不要用明文或可逆加密存密码。
概念解释
BCrypt 自带盐值,强度因子越高计算越慢、越难暴力破解,但登录与注册 CPU 成本上升。因子按服务器性能与安全要求标定,存储哈希不存储可逆加密结果。
原理流程
- 选择强度因子构造编码器。
- 注册时编码原始密码存哈希。
- 登录按同算法比对。
- 因子调整后新密码用新强度,旧哈希可在登录时升级。
代码或图示
@Bean
open fun passwordEncoder(): PasswordEncoder = BCryptPasswordEncoder(12)
常见误区
- 因子过低:哈希易被破解;过高:登录请求 CPU 被打满。
- 自己实现哈希加盐:不如成熟编码器经过验证。
追问
- 还有哪些编码器?答:Argon2、PBKDF2、SCrypt 等,选型见安全基线资料。
- 哈希算法升级怎么做?答:登录检测旧格式并重新编码,通用密码策略见 06.1。
06.8.2.3-059 如何关闭默认账号与初始密码?
一句话结论
生产配置不使用 Security 默认生成的用户/密码,自定义 UserDetailsService 或 UserDetailsManager 加载真实用户;移除默认账号自动配置,初始账号只存在于本地开发 profile。
概念解释
Security 自动配置在缺省时生成随机控制台密码或默认用户,仅用于快速体验。生产必须接入用户存储,禁用默认账号;开发固定账号放在 dev Profile 配置中并隔离。
原理流程
- 提供自定义用户服务/管理器 Bean。
- 默认自动配置被自定义实现覆盖。
- 生产配置不写固定开发账号。
- dev Profile 单独提供演示账号。
代码或图示
// 生产:自定义 UserDetailsService 接入用户表
// dev Profile:仅本地演示账号配置,不进入生产环境
常见误区
- 把开发默认账号留在生产配置:弱凭证上线。
- 依赖启动日志打印的随机密码作为生产账号:流程不可控。
追问
- 自动配置如何被覆盖?答:提供同类型 Bean 替代默认实现;通用自动配置条件见 06.2。
- 初始管理员如何创建?答:初始化脚本/管理流程创建,不在应用配置硬编码。
06.8.2.3-060 测试中如何模拟登录用户?
一句话结论
方法级测试用 @WithMockUser 注解指定用户名与角色/权限,Security 测试上下文建立模拟认证;Web 层测试通过 MockMvc 安全请求或注解注入模拟主体,不必走真实登录流程。
概念解释
安全测试切片可注入预设认证主体。@WithMockUser 在测试方法/类上声明角色与权限,安全上下文加载模拟用户;控制器与方法安全注解据此判断授权。
原理流程
- 测试标注
@WithMockUser或构建请求主体。 - 测试安全上下文设置模拟认证。
- 被测方法/请求走授权判断。
- 断言响应状态与行为。
代码或图示
@Test
@WithMockUser(roles = ["ADMIN"])
fun `admin can approve`() = runTest {
service.approve(order)
}
常见误区
- 测试未模拟主体:受保护方法/路径按匿名访问断言,401/403 误判。
- 角色前缀在测试注解中重复书写:
@WithMockUser(roles=...)自动带 ROLE_ 前缀。
追问
- 自定义主体类型怎么模拟?答:
@WithUserDetails走测试用户服务,或自定义测试安全注解;通用测试安全见 06.2。 - MockMvc 如何带认证?答:
.with(user(...))请求后处理器,见 MockMvc 测试条目。
06.8.2.3-061 Kotlin 控制器中如何获取当前登录用户?
一句话结论
同步控制器可注入 Principal/Authentication 参数,或从 SecurityContext 读取;响应式/协程链路按上下文桥接获取,推荐把用户标识作为方法参数显式传入服务层,避免静态上下文依赖。
概念解释
控制器入口能拿到认证主体对象,提取用户 ID/权限后传给服务。Kotlin 可空类型表达匿名场景;服务层不直接访问安全上下文,便于测试与分层。
原理流程
- 控制器方法接收
Authentication/Principal参数。 - 提取主体标识与权限。
- 作为参数调用服务方法。
- 服务层只依赖显式参数。
代码或图示
@GetMapping("/me")
fun me(auth: Authentication): UserMe {
val userId = auth.name
return currentService.profileOf(userId)
}
常见误区
- 服务层静态读 SecurityContext:响应式/协程下可能丢失,测试难替换。
- 主体对象直接传给下游:泄漏认证细节,应提取必要标识。
追问
- Principal 与 Authentication 关系?答:Authentication 是 Principal 的扩展,含权限与凭证;通用安全模型见 06.2。
- 匿名用户怎么判断?答:
auth.authorities含匿名角色或主体为 null 时分支处理。
06.8.2.3-062 权限表达式中的 Kotlin 集合如何配合?
一句话结论
安全表达式运行在 SpEL 上下文中,不能直接操作 Kotlin 集合方法;主体权限集合由 Security 提供判断方法,集合转换与业务判断放在服务层 Kotlin 代码中完成。
概念解释
表达式只访问公开属性与简单判断,Kotlin 集合扩展、lambda 不参与 SpEL 求值。需要复杂集合包含/过滤逻辑时,抽自定义 Bean 方法在表达式中调用,内部用 Kotlin 实现。
原理流程
- 注解表达式引用主体权限与参数。
- SpEL 调用内置判断或自定义 Bean。
- 复杂集合逻辑在 Kotlin 方法内执行。
- 返回布尔结果给表达式。
代码或图示
@PreAuthorize("@accessChecker.canAccess(#doc, authentication)")
open fun view(doc: Document) { }
常见误区
- 表达式里写 Kotlin
map/filter:SpEL 不识别,求值失败。 - 权限集合直接暴露给前端判断:授权必须在服务端校验。
追问
- 自定义检查器 Bean 怎么注册?答:普通 Spring Bean,表达式按名引用。
- 表达式能调用静态方法吗?答:SpEL 支持静态引用,但项目内优先用 Bean 方法便于测试。
06.8.2.3-063 自定义认证过滤器用 Kotlin 如何实现?
一句话结论
继承 OncePerRequestFilter,重写 doFilterInternal,从请求提取凭证、校验并构建 Authentication,设置 SecurityContext 后放行;异常不自行写响应,交给入口处理器。
概念解释
过滤器每请求执行一次,职责是解析与认证。Kotlin 类继承过滤器父类,挂起/阻塞按运行时模型选择;凭证解析失败清空上下文并继续链,由后续入口返回 401。
原理流程
- 读取请求头/参数凭证。
- 校验令牌/凭证有效性。
- 构建认证对象存入上下文。
- 调用过滤器链继续,失败由入口处理。
代码或图示
class JwtAuthFilter(private val tokenService: TokenService) : OncePerRequestFilter() {
override fun doFilterInternal(
request: HttpServletRequest,
response: HttpServletResponse,
chain: FilterChain,
) {
val token = request.extractBearer()
if (token != null && tokenService.valid(token)) {
SecurityContextHolder.getContext().authentication = tokenService.authentication(token)
}
chain.doFilter(request, response)
}
}
常见误区
- 过滤器内直接写 401 响应:绕过统一入口处理。
- 每次请求重复加载用户未缓存:认证开销放大。
追问
- 响应式过滤器基类?答:WebFlux 用 WebFilter 体系,与 Servlet Filter 不同;通用过滤器见 06.2。
- 过滤器依赖注入?答:声明为 Bean,构造器注入服务。
06.8.2.3-064 Security 配置中的敏感配置如何注入?
一句话结论
密钥、记住我 key、令牌有效期等通过 @ConfigurationProperties 或构造器注入外部配置,不硬编码在 DSL 代码中;敏感值不写进源码与日志,配置类保持不可变接收。
概念解释
安全参数来自环境配置,代码只引用配置对象。Kotlin 配置类构造器注入属性 Bean,DSL 块读取配置值;密钥轮换通过外部配置更新,不改代码。
原理流程
- 定义安全配置属性 data class。
- 外部属性源注入配置 Bean。
- 安全配置类构造器引用配置。
- DSL 使用配置值构造编码器/过滤器。
代码或图示
@ConfigurationProperties("security")
data class SecurityProps(val jwtSecret: String, val tokenTtlSeconds: Long = 3600)
常见误区
- DSL 块内写死密钥字符串:源码泄漏风险。
- 日志打印配置对象:敏感字段输出到日志。
追问
- 密钥从秘钥服务获取?答:启动时注入环境变量/秘钥管理,通用配置外部化见 06.2。
- 配置校验怎么做?答:配置类加约束注解,启动期校验。
06.8.2.3-065 Security 配置类需要 allopen 开放吗?
一句话结论
需要被 Spring 配置代理增强的 @Configuration 类与 @Bean 方法同样需要可开放;安全配置类与普通配置类遵循同一 allopen 规则,代理失效会导致 Bean 互调不经过容器。
概念解释
SecurityFilterChain Bean 定义在配置类中,配置类代理保证 @Bean 方法互调走容器。Kotlin 默认 final 阻断子类化,allopen Spring 预设覆盖 @Configuration 时自动开放;未覆盖则显式 open。
原理流程
- 安全配置类标注
@Configuration。 - allopen 预设开放类与 Bean 方法,或显式 open。
- 容器生成配置代理。
- 过滤器链 Bean 方法互调经容器拦截。
代码或图示
@Configuration
open class SecurityConfig {
@Bean
open fun filterChain(http: HttpSecurity): SecurityFilterChain { /* ... */ }
}
常见误区
- 只关注过滤器逻辑,忽略配置类开放:代理静默退化。
- allopen 预设未包含安全配置注解:类仍 final,启动/行为异常。
追问
- 如何验证配置代理生效?答:检查
@Bean互调是否返回容器单例,见 06.8.2.1 配置代理条目。 - Security 组件本身需要 open 吗?答:被 AOP 增强的服务方法才需要,过滤器 Bean 视代理需求而定。
06.8.2.3-066 Spring Boot 测试中 Kotlin 相关依赖有哪些?
一句话结论
spring-boot-starter-test 聚合 JUnit、MockMvc、AssertJ 等;Kotlin 项目按需加入 kotlin-test(断言)、Kotest(可选测试框架)、mockk(Kotlin 友好 mock)与协程测试依赖,版本与 Kotlin 对齐。
概念解释
测试栈分三层:Spring 测试切片与上下文、断言库、Mock 框架。Kotlin 侧用 kotlin-test/mockk 替代 Java 习惯的 JUnit 断言与 Mockito;协程测试用 runTest 与对应桥接。
原理流程
- 引入 starter-test 获得 Spring 测试支撑。
- 加 kotlin-test 断言与协程测试工具。
- 加 mockk 创建桩件。
- 版本随 Kotlin/Boot 兼容矩阵核对。
代码或图示
// 测试依赖示意;坐标与版本以官方 BOM/矩阵为准(待确认)
// testImplementation("org.jetbrains.kotlin:kotlin-test")
// testImplementation("io.mockk:mockk")
// testImplementation("org.springframework.boot:spring-boot-starter-test")
常见误区
- 只引 starter-test 却用 mockk 语法:缺 mockk 依赖解析失败。
- 测试库版本与 Kotlin 编译器不匹配:编译或运行异常。
追问
- JUnit 5 与 Kotlin 测试共存吗?答:可以,kotlin-test 可适配 JUnit 平台;通用测试栈见 06.2。
- 协程测试依赖是哪个?答:kotlinx-coroutines-test,提供 runTest 与测试调度器。
06.8.2.3-067 kotlin-test 断言如何书写?
一句话结论
kotlin-test 提供 assertEquals、assertTrue、assertFailsWith 等断言函数,直接在 Kotlin 测试中使用,替代 AssertJ/ JUnit 断言的链式风格;断言失败带消息与实际/期望值。
概念解释
断言函数是顶层/扩展函数,按可空性与集合语义适配 Kotlin。集合断言、异常断言、布尔判断都有对应函数;测试方法可用 backtick 命名提升可读性。
原理流程
- 执行被测代码得到结果。
- 调用断言函数比较期望与实际。
- 失败抛出断言异常,标记测试失败。
- 异常场景用
assertFailsWith捕获类型。
代码或图示
@Test
fun `discount applies to premium`() {
val price = pricing.finalPrice(1000, UserType.PREMIUM)
assertEquals(800, price)
}
常见误区
- 断言消息只写「失败」:定位时看不出期望值与场景。
- 集合断言只比较引用:应比较内容相等性。
追问
- 异常断言怎么写?答:
assertFailsWith<IllegalArgumentException> { ... }并可校验消息。 - 与 AssertJ 能混用吗?答:可以,但项目内统一一种断言风格更一致。
06.8.2.3-068 Kotest 如何与 @SpringBootTest 集成?
一句话结论
Kotest 是风格化测试框架,可作为 JUnit 平台引擎运行;需要 Spring 上下文时配合 Spring 监听器/扩展注入应用上下文,或直接用 Spring 测试注解驱动,按团队选择 Kotest 规格风格或标准 JUnit 测试类。
概念解释
Kotest 用 Spec 描述测试结构,替代 JUnit 类方法模型。Spring 集成通过对应扩展把上下文生命周期接入 Kotest 生命周期;上下文切片注解仍按 Spring 测试体系配置。
原理流程
- 引入 Kotest 与 Spring 集成扩展。
- 编写 Spec 定义用例。
- 扩展启动/关闭 Spring 上下文。
- 注入 Bean 执行集成测试。
代码或图示
class OrderServiceTest : FunSpec({
// Spring 上下文注入与 Bean 装配按 Kotest Spring 扩展配置
test("create order persists") { /* ... */ }
})
常见误区
- 只引 Kotest 不接 Spring 扩展:上下文不会自动启动。
- Kotest 生命周期与 Spring 上下文缓存假设不一致:上下文复用行为需按扩展文档确认(待确认)。
追问
- 团队已有 JUnit 测试要换 Kotest 吗?答:不必强制,新旧可共存,按模块逐步迁移。
- 参数化测试在 Kotest 怎么写?答:Spec 提供参数化测试构造器,与 JUnit 参数化注解二选一。
06.8.2.3-069 mockk 如何替代 Mockito 创建桩件?
一句话结论
mockk<T>() 创建模拟对象,every { 调用 } returns 结果 打桩,verify { 调用 } 验证交互;mockk 原生支持 Kotlin final 类与不可变构造,不像 Mockito 需要开启 final 类 mock 支持。
概念解释
mockk 面向 Kotlin 设计,能模拟普通类、final 类与协程函数。打桩指定方法调用与返回值,验证调用次数与参数;构造器 mock 与 relaxed mock 各有对应 API。
原理流程
mockk创建依赖桩件。every定义方法返回/行为。- 被测类注入桩件执行。
verify校验交互次数与参数。
代码或图示
val repository = mockk<OrderRepository>()
every { repository.findByIdOrNull(1L) } returns sampleOrder
val service = OrderService(repository)
verify(exactly = 1) { repository.save(any()) }
常见误区
- every 未打桩的方法返回 null/抛异常:按需使用 relaxed mock 或补齐桩件。
- mockk 语法与 Mockito 混用:两套桩件模型不要交叉。
追问
- 模拟 final 类还需要特殊开关吗?答:mockk 原生支持 Kotlin final 类,无需 Mockito 的 inline mock 配置。
- relaxed mock 怎么用?答:
mockk(relaxed = true)对未打桩方法返回默认桩,适合多依赖桩件。
06.8.2.3-070 协程挂起函数在 mockk 中如何打桩与验证?
一句话结论
挂起函数用 coEvery { 挂起调用 } returns 结果 打桩,coVerify { 挂起调用 } 验证;普通函数用 every/verify,二者不能混用,协程测试在 runTest 中执行。
概念解释
mockk 区分阻塞与挂起调用:co 系列扩展识别 suspend 方法,处理挂起返回与协程上下文。桩件返回 suspend 结果或抛异常,验证调用次数与参数在测试协程内完成。
原理流程
- mockk 创建协程依赖桩件。
coEvery定义挂起方法返回值。- 被测 suspend 方法调用桩件。
coVerify校验挂起交互。
代码或图示
val client = mockk<UserClient>()
coEvery { client.findSuspend(1L) } returns sampleUser
@Test
fun `loads user`() = runTest {
val result = service.profile(1L)
coVerify(exactly = 1) { client.findSuspend(1L) }
}
常见误区
- 挂起方法用
every打桩:mockk 识别不了 suspend 调用,行为异常。 - 不在协程测试环境调用挂起桩件:上下文缺失导致运行错误。
追问
- 挂起方法抛异常怎么桩?答:
coEvery { ... } throws DomainException。 - Flow 返回值怎么模拟?答:桩件返回
flowOf(...)构造的 Flow,收集断言序列。
06.8.2.3-071 @SpringBootTest 在 Kotlin 测试类中如何使用?
一句话结论
测试类标注 @SpringBootTest 启动完整应用上下文,构造器注入被测 Bean;Kotlin 测试类用主构造器接收依赖,配合测试框架生命周期执行用例,上下文按配置缓存复用。
概念解释
集成测试启动真实容器,装配服务、仓库与配置。Kotlin 构造器注入让测试类直接持有 Bean 引用;完整上下文启动慢,适合跨层集成验证,单元/切片测试优先用更轻量上下文。
原理流程
- 测试类标注
@SpringBootTest。 - 启动 ApplicationContext 装配全部 Bean。
- 构造器注入被测服务与依赖桩件。
- 测试方法执行业务流程并断言。
代码或图示
@SpringBootTest
class OrderIntegrationTest(
private val orderService: OrderService,
) {
@Test
fun `creates order`() { /* ... */ }
}
常见误区
- 每个纯单元测试都启动完整上下文:测试套件缓慢。
- 测试类用字段注入:Kotlin 构造器注入更直接且不可变。
追问
- 上下文如何指定配置类?答:
classes属性覆盖默认配置;通用测试上下文见 06.2。 - 测试数据库怎么准备?答:测试配置连接库/内存库或 Testcontainers,见数据准备条目。
06.8.2.3-072 @WebMvcTest 切片测试如何在 Kotlin 中使用?
一句话结论
@WebMvcTest 只装载 Web 层控制器与 MVC 基础设施,服务依赖用 mockk/Mockito 桩件替换;适合验证控制器路由、参数绑定与响应序列化,不启动完整服务与仓库。
概念解释
切片测试缩小上下文范围:注册指定控制器,其他 Bean 通过桩件注入。Kotlin 测试类注入 MockMvc 与桩件,验证 HTTP 层行为;仓库、远程服务都不在切片内真实装配。
原理流程
- 标注
@WebMvcTest(controllers = [...])。 - 容器装载控制器与 MVC 组件。
@MockBean/mockk 提供服务桩件。- 通过 MockMvc 发请求断言响应。
代码或图示
@WebMvcTest(UserController::class)
class UserControllerTest {
@Autowired lateinit var mockMvc: MockMvc
@MockK lateinit var userService: UserService
}
常见误区
- 切片内期望仓库 Bean 存在:未被装载,应打桩服务层。
- 列出过多控制器:切片失去隔离意义。
追问
- 安全过滤器在切片中加载吗?答:可按需引入安全测试配置,通用切片机制见 06.2。
- Kotlin mockk 与
@MockBean如何配合?答:可用 mockk 桩件注册为 Bean,具体集成方式以测试栈版本为准(待确认)。
06.8.2.3-073 @DataJpaTest 切片如何验证实体与仓库?
一句话结论
@DataJpaTest 只装载 JPA 层实体仓库与数据源,默认事务回滚;适合验证实体映射、仓库查询与约束,服务与 Web 层不在切片内装配,可替换测试数据库。
概念解释
JPA 切片扫描实体与仓库,配置内存数据库或 Testcontainers 数据源。测试方法默认在事务中执行并回滚,不污染库;验证派生查询、投影映射与关联加载行为。
原理流程
- 标注
@DataJpaTest。 - 容器装载实体管理器与仓库。
- 注入仓库执行查询/保存。
- 断言结果,事务结束回滚。
代码或图示
@DataJpaTest
class OrderRepositoryTest(
private val repository: OrderRepository,
) {
@Test
fun `finds by status`() {
repository.save(sampleOrder())
assertEquals(1, repository.findByStatus(OrderStatus.PENDING).size)
}
}
常见误区
- 切片内调用服务层 Bean:未装配,应拆到集成测试。
- 依赖生产数据源配置:切片默认替换为测试库,可显式覆盖。
追问
- 实体映射错误在哪暴露?答:切片启动期元数据解析与首次查询即可发现。
- 关闭回滚怎么做?答:
@Transactional(propagation=...)或测试配置调整,通用测试事务见 06.2。
06.8.2.3-074 MockMvc 结果在 Kotlin 中如何断言?
一句话结论
MockMvc 请求后用 andExpect 校验状态码、JSON 路径与内容;Kotlin 测试可结合 kotlin-test 提取响应体反序列化为 data class 断言,避免只看字符串匹配。
概念解释
MockMvc 不启动真实端口,在内存中调度控制器。结果断言分状态码、视图/JSON 路径、响应体三类;复杂响应可反序列化为 DTO 用结构化断言比较。
原理流程
- 构造 MockMvc 请求(方法、路径、体、参数)。
- 执行请求得到结果。
- 断言状态码与 JSON 字段。
- 需要时解析响应体为 data class 再断言。
代码或图示
mockMvc.get("/users/1")
.andExpect { status { isOk() } }
.andExpect { jsonPath("$.nickname").value("Ann") }
常见误区
- 用整段 JSON 字符串比对:字段顺序与无关字段导致脆弱断言。
- 不校验状态码只校验体:错误响应被误判通过。
追问
- 请求体怎么传?答:
contentType+content(objectMapper.writeValueAsString(dto))。 - 异步/流式端点怎么测?答:MockMvc 对异步结果有专门断言支持,WebFlux 测试用对应客户端。
06.8.2.3-075 测试中如何注入 ApplicationContext?
一句话结论
测试类构造器注入 ApplicationContext 字段,或方法参数接收;用于按类型/名称取 Bean、验证上下文装配与条件配置,集成测试中辅助排查 Bean 定义与候选歧义。
概念解释
上下文是测试容器的入口,可断言关键 Bean 存在、类型正确、条件装配结果符合预期。单元测试不需要上下文;集成/切片测试按需注入,避免在测试里静态获取全局容器。
原理流程
- 测试类声明 ApplicationContext 依赖。
- 上下文启动后注入。
- 按类型/名称获取 Bean 断言。
- 验证配置类、条件 Bean 装配结果。
代码或图示
@SpringBootTest
class ContextCheckTest(private val context: ApplicationContext) {
@Test
fun `client bean present`() {
assertNotNull(context.getBean(ThirdPartyClient::class.java))
}
}
常见误区
- 单元测试也注入上下文:失去隔离与速度优势。
- 按硬编码 Bean 名断言:重构改名后测试脆弱,优先按类型断言。
追问
- 如何列出上下文中所有 Bean?答:
context.beanDefinitionNames遍历核对。 - 条件装配结果怎么验证?答:按类型断言 Bean 存在/缺失,配合 Profile 属性源。
06.8.2.3-076 测试方法上的 @Transactional 回滚机制如何工作?
一句话结论
测试类/方法标注 @Transactional 后,每个测试在事务中执行,结束默认回滚,数据库变更不残留;需要提交验证真实落库时显式关闭回滚,配合测试数据库隔离。
概念解释
测试事务复用生产事务管理器,测试方法包裹事务,结束回滚而非提交。这样仓库测试互不污染;验证提交行为、触发器、外键等需要真实提交时,才用非回滚测试策略。
原理流程
- 测试方法开启事务。
- 执行保存/查询操作。
- 断言业务结果。
- 方法结束回滚,数据还原。
代码或图示
@DataJpaTest
class RepositoryTest {
@Test
@Transactional
fun `save then find`() { /* 结束回滚 */ }
}
常见误区
- 测试间依赖残留数据:回滚后下一个测试看不到上一测试数据。
- 期望回滚仍能验证提交后行为:回滚不触发提交期触发器与刷新。
追问
- 如何让测试数据提交?答:标注关闭回滚或用独立事务策略,通用测试事务见 06.2。
- 回滚与 JPA 快照关系?答:测试事务内脏检查正常工作,回滚清除快照。
06.8.2.3-077 协程测试如何用 runTest 与测试调度器?
一句话结论
runTest 提供测试调度器并虚拟推进延时,被测 suspend 函数在其中执行;需要隔离真实阻塞时替换调度器,断言挂起结果、超时分支与取消行为,不必真实等待。
概念解释
kotlinx-coroutines-test 的 runTest 启动测试协程,delay 不真实等待。可注入测试调度器验证并发时序;阻塞 IO 测试需独立线程池,不能用测试调度器跑阻塞调用。
原理流程
- 测试方法体放入
runTest { }。 - 调用被测 suspend 方法。
- 虚拟时钟跳过延时,立即断言结果。
- 验证异常、取消或并发任务完成状态。
代码或图示
@Test
fun `returns fallback on timeout`() = runTest {
val result = service.withTimeoutFallback(id)
assertEquals(Fallback, result)
}
常见误区
- 在 runTest 中跑阻塞 JDBC/同步 HTTP:测试调度器不承载阻塞。
- 不取消后台子协程:测试作用域结束时未完成任务可能泄漏告警。
追问
- TestDispatcher 怎么替换到生产代码?答:调度器作为依赖注入,测试传入测试调度器。
- 虚拟时间能验证真实超时吗?答:超时分支可验证,真实延迟稳定性需单独集成测试。
06.8.2.3-078 Flow 序列如何测试?
一句话结论
收集 Flow 为列表断言元素序列,或用 Turbine 类流测试工具逐个断言发射元素、完成与异常;冷热流分别构造订阅,验证取消时清理逻辑执行。
概念解释
Flow 测试关注发射顺序、元素内容、错误与完成事件。基础场景 toList() 收集断言;时序与背压场景用专门流测试库逐个消费事件。取消行为在 finally 断言资源释放。
原理流程
- 构造被测 Flow。
- 订阅收集元素。
- 断言序列与事件类型。
- 取消订阅验证清理。
代码或图示
@Test
fun `emits items in order`() = runTest {
val items = eventStream.take(2).toList()
assertEquals(listOf(a, b), items)
}
常见误区
- 只断言第一个元素:后续发射错误未覆盖。
- 热流测试未控制订阅时机:收到历史/回放元素干扰断言。
追问
- Turbine 是什么?答:协程流测试库,逐元素挂起断言流事件;坐标与版本以库文档为准(待确认)。
- Flow 异常怎么断言?答:收集时捕获流异常类型,或测试库的错误事件断言。
06.8.2.3-079 测试数据如何用 data class 工厂方法构造?
一句话结论
测试夹具用工厂函数/默认值 data class 构造,关键字段必填、其余给测试默认值;集中夹具方法避免每个测试重复堆砌字段,变更字段时只改工厂一处。
概念解释
测试对象构建散落各处会在字段调整时大面积改测试。工厂函数提供合法默认实例,测试按需覆盖个别字段;命令 DTO 与实体夹具分目录组织,保持测试数据可读。
原理流程
- 定义夹具工厂返回合法测试实例。
- 测试调用工厂并覆盖必要字段。
- 字段结构变更只改工厂。
- 夹具不依赖数据库已存在数据。
代码或图示
fun testOrder(id: Long = 1L, status: OrderStatus = OrderStatus.PENDING) =
Order(id = id, status = status, amount = BigDecimal.TEN)
常见误区
- 夹具隐式依赖其他测试插入的数据:测试顺序耦合。
- 每个测试手写全部字段:字段新增时漏改多处。
追问
- 实体夹具与 DTO 夹具分开吗?答:分开,避免持久化模型与接口模型混用。
- 复杂聚合怎么造?答:工厂内组合子对象,保证关联一致。
06.8.2.3-080 参数化测试在 Kotlin 中如何写?
一句话结论
JUnit 参数化测试用 @ParameterizedTest + 值源/枚举源/方法提供参数;Kotlin 可在方法提供器返回数据类列表,每组参数跑一次用例,断言逻辑复用。
概念解释
参数化把同一测试逻辑套多组输入输出。参数源支持字面量、枚举、方法工厂;Kotlin 数据类作为参数载体传递组合输入,减少重复测试方法。
原理流程
- 测试方法声明参数列表。
- 源注解/方法提供参数集合。
- 框架逐组调用测试方法。
- 每组独立断言与报告结果。
代码或图示
@ParameterizedTest
@ValueSource(strings = ["ann", "bob"])
fun `accepts valid login`(login: String) {
assertTrue(validator.valid(login))
}
常见误区
- 参数命名不含场景含义:失败时看不出哪组输入出问题。
- 组合参数塞一个字符串拆分:应直接用数据类参数。
追问
- Kotest 参数化怎么写?答:Spec 提供
forAll/参数化构造器,与 JUnit 注解二选一。 - 空参数集合会怎样?答:测试被跳过,需保证源至少一组有效用例。
06.8.2.3-081 如何断言抛出指定异常?
一句话结论
kotlin-test 用 assertFailsWith<T> { } 捕获并断言异常类型与消息;协程代码在 runTest 内调用,业务异常与取消异常分别断言,不把取消异常当普通错误吞掉。
概念解释
异常断言验证非法输入/状态的失败路径。assertFailsWith 要求块内抛出指定类型,否则失败;可进一步断言消息与属性。协程取消是特殊异常,单独处理。
原理流程
- 块内执行应失败的调用。
- 框架捕获抛出的异常。
- 校验类型匹配(可选消息/属性)。
- 未抛异常或类型不符则测试失败。
代码或图示
@Test
fun `rejects negative amount`() {
assertFailsWith<IllegalArgumentException> {
pricing.calculate(-100)
}
}
常见误区
- 断言过宽的
Exception:掩盖具体错误类型。 - 在协程里吞掉
CancellationException再断言:取消语义被破坏。
追问
- 断言异常消息包含片段?答:返回异常实例后
assertTrue(ex.message?.contains(...) == true)。 - 异步流程异常怎么捕获?答:收集流结果或 await 后断言,不要忽略后台协程异常。
06.8.2.3-082 测试属性源如何配置?
一句话结论
@TestPropertySource 或属性源注解注入测试专属配置,覆盖默认值;Kotlin 配置类在测试上下文中按测试属性绑定,避免修改生产配置文件造测试条件。
概念解释
测试需要独立的开关、地址、阈值。属性源在上下文启动时注入环境属性,优先级高于默认配置;多组测试配置可用嵌套配置类或 Profile 区分。
原理流程
- 测试类标注属性源键值/文件。
- 上下文环境合并测试属性。
- 配置类绑定测试值。
- 断言行为按测试配置执行。
代码或图示
@SpringBootTest(properties = ["feature.promo=false"])
class PromoDisabledTest
常见误区
- 直接改生产 application.yml 适配测试:污染默认环境。
- 测试属性键与配置类字段名不匹配:绑定回退默认值,断言误判。
追问
- 测试专用配置文件放哪?答:test resources 下,按 Profile 加载;通用外部化配置见 06.2。
- 上下文缓存对属性敏感吗?答:不同属性源形成不同缓存键,通用缓存规则见 06.2。
06.8.2.3-083 切片测试如何排除不需要的自动配置?
一句话结论
切片注解本身限定装载范围;额外用 @ImportAutoConfiguration(exclude=...) 或测试属性关闭不需要的自动配置,保持切片轻量,避免无关 Bean 与外部连接被装配。
概念解释
自动配置在测试上下文按需生效。切片已排除大部分通用配置,仍可能引入不需要的客户端、消息中间件配置。显式排除减少启动依赖与外部连接,测试更稳定快速。
原理流程
- 选择对应切片注解。
- 列出误装配的自动配置类。
- 排除或用属性关闭。
- 启动验证切片只含目标组件。
代码或图示
@WebMvcTest(OrderController::class)
@ImportAutoConfiguration(exclude = [RemoteClientAutoConfiguration::class])
class OrderControllerTest
常见误区
- 切片测试尝试连外部中间件:未排除自动配置导致等待连接。
- 排除过度:被测依赖的配置也被剔除,上下文缺 Bean。
追问
- 如何查看切片装配了哪些配置?答:启动调试日志或上下文 Bean 列表核对。
- 通用自动配置条件见 06.2:条件不满足的配置本就不会装配。
06.8.2.3-084 mockk 对 Kotlin 默认 final 类的支持如何?
一句话结论
mockk 原生模拟 Kotlin final 类与普通类,不需要 Mockito 那样开启 inline/final 开关;未开放的 Kotlin 服务/仓库接口都可直接打桩,这是 Kotlin 项目选 mockk 的主要原因之一。
概念解释
Mockito 默认不能 mock final 类,需要额外内联配置;mockk 的模拟机制覆盖 Kotlin 封闭类。Kotlin 依赖多为 final 类/data class,mockk 直接 mockk<T>() 即可。
原理流程
- 识别被测依赖类型(final 类/接口)。
mockk创建模拟实例。- 打桩与验证按 mockk API。
- 注入被测服务。
代码或图示
// Kotlin final 类也可直接 mock
val store = mockk<FinalOrderStore>()
every { store.save(any()) } returns persisted
常见误区
- 沿用 Mockito 思路找 final mock 开关:mockk 不需要。
- 模拟 data class 却校验其结构相等:桩件行为按打桩方法,不按字段。
追问
- Mockito 在 Kotlin 项目完全不可用吗?答:可用,但 final 类需额外配置,体验不如 mockk。
- mockk 能模拟伴生对象/静态方法吗?答:对应 mockk 静态/伴生 API,见 mockk 文档(待确认版本细节)。
06.8.2.3-085 Testcontainers 在 Kotlin 项目中如何接入?
一句话结论
测试启动数据库/中间件容器,仓库测试连接容器内实例;Kotlin 测试类通过容器依赖管理生命周期,保证集成测试与真实数据库版本一致,替代内存库的行为差异。
概念解释
Testcontainers 在测试生命周期启动 Docker 容器,提供真实 DB/消息中间件连接。适合验证 SQL 方言、迁移与约束;单测仍用桩件,集成测试按需要起容器。
原理流程
- 测试声明容器实例与启动规则。
- 容器就绪后获取连接配置。
- 上下文数据源接入容器。
- 测试结束容器自动销毁。
代码或图示
// 容器声明与数据源接入按 Testcontainers Spring 集成方式配置
// 具体注解/依赖坐标以官方文档为准(待确认)
常见误区
- 所有单元测试都起容器:套件慢且依赖 Docker 环境。
- 容器版本与生产不一致:方言/行为差异没暴露。
追问
- 容器复用策略?答:可配置单例容器跨测试类复用,缩短启动时间。
- CI 环境需要什么?答:Docker 服务可用,通用集成测试环境见 08 分册。
06.8.2.3-086 数据库迁移如何在测试中验证?
一句话结论
集成测试在干净库上执行迁移脚本再跑仓库断言,验证 schema 与变更可重复执行;可每次全新建库或校验迁移版本,防止迁移脚本与实体映射漂移。
概念解释
迁移(Flyway/Liquibase 等)与实体注解可能不一致。测试从空库执行迁移,再用仓库读写验证列、约束、索引;结合 CI 每次建库避免旧库残留掩盖问题。
原理流程
- 测试数据源指向全新空库。
- 启动时执行迁移脚本。
- 仓库测试读写验证 schema。
- 断言映射字段、约束与关联正确。
代码或图示
// 验证链:空库 -> 迁移脚本 -> 实体映射 -> 仓库读写 -> 约束/索引断言
常见误区
- 测试库沿用旧 schema:迁移脚本从未在干净库验证。
- 只测实体保存不测查询约束:唯一/外键冲突路径遗漏。
追问
- 迁移工具版本与方言?答:按项目所用迁移工具核对,通用数据库迁移见 05 分册。
- 回滚迁移要测吗?答:按项目迁移策略评估回滚脚本验证范围。
06.8.2.3-087 测试日志与上下文缓存要注意什么?
一句话结论
上下文按配置特征缓存复用,测试间共享单例 Bean;不要在测试中修改单例可变状态,日志级别按测试需要调整,断言失败时保留上下文配置与 Bean 清单辅助定位。
概念解释
缓存上下文提升测试速度,但共享带来状态污染风险。数据变更由测试事务回滚处理;组件内可变缓存、静态单例需测试间清理。日志在排障时临时调级,不写进生产配置。
原理流程
- 测试配置计算上下文缓存键。
- 命中复用已有上下文与单例。
- 测试数据在事务回滚或夹具清理。
- 可变单例状态需显式重置。
代码或图示
// 避免:测试中改写单例缓存且不还原
// 推荐:数据经事务回滚;可变组件提供重置方法
常见误区
- 测试依赖执行顺序:上一测试残留状态被下一测试读到。
- 为排障把 debug 日志留在测试配置:套件输出噪音增大。
追问
- 如何强制重建上下文?答:调整缓存键或使用上下文缓存控制注解;通用测试上下文见 06.2。
- 单例 Bean 状态污染怎么查?答:定位可变字段,在夹具中初始化或注入新实例。
06.8.2.3-088 MockMvc 如何测试协程端点?
一句话结论
Web 层测试仍通过 MockMvc/测试客户端发起请求,框架桥接协程处理器;断言响应与普通端点一致,服务层协程依赖用 coEvery 打桩,测试方法按需要进入协程测试环境。
概念解释
协程是处理器内部实现,HTTP 测试入口不变。控制器依赖的 suspend 服务桩件用 mockk 协程打桩;WebFlux 测试用对应测试客户端,MVC MockMvc 承接异步协程结果。
原理流程
- 测试装配控制器与协程桩件。
- 发起 MockMvc/客户端请求。
- 框架桥接执行 suspend 处理器。
- 断言响应状态与体。
代码或图示
@Test
fun `user endpoint returns json`() = runTest {
coEvery { userService.findSuspend(1L) } returns sampleUser
mockMvc.get("/users/1").andExpect { status { isOk() } }
}
常见误区
- 协程服务桩件用普通
every:挂起调用未正确打桩。 - 测试未等待协程完成就断言:响应尚未写出。
追问
- WebFlux 测试客户端?答:
WebTestClient装配方式见 Spring 测试文档,与 MockMvc 二选一按运行时。 - 流式端点怎么测?答:订阅流逐个断言事件,见 Flow 测试条目。
06.8.2.3-089 如何断言未认证 401 与无权限 403?
一句话结论
MockMvc 请求带安全测试配置,未认证访问受保护路径断言 401,已认证但缺权限断言 403;通过请求后处理器模拟主体或匿名访问,验证授权规则而非只测登录成功路径。
概念解释
安全测试要覆盖拒绝路径:匿名请求、低权限主体、高权限主体三种身份分别断言状态码。@WithMockUser 或请求后处理器设置主体,配合安全切片配置加载过滤器链。
原理流程
- 装配安全测试上下文。
- 构造匿名/模拟主体请求。
- 访问受保护端点。
- 断言 401(未认证)或 403(无权限)。
代码或图示
@Test
fun `anonymous gets 401`() {
mockMvc.get("/admin/reports").andExpect { status { isUnauthorized() } }
}
@Test
@WithMockUser(roles = ["USER"])
fun `user forbidden from admin`() {
mockMvc.get("/admin/reports").andExpect { status { isForbidden() } }
}
常见误区
- 只测有权限的happy path:拒绝规则未验证。
- 安全过滤器未在切片加载:请求绕过授权直接 200。
追问
- 自定义入口处理器返回 JSON 怎么断言?答:断言响应体错误码字段,不只看状态码。
- 角色前缀在测试注解中?答:
roles自动补ROLE_,与生产规则一致。
06.8.2.3-090 测试中如何验证配置属性绑定?
一句话结论
测试上下文注入配置 data class,断言字段按测试属性绑定与默认回退;可直接构造配置类做纯单测,绑定行为用上下文测试验证,覆盖缺失键、类型转换与校验违例场景。
概念解释
配置绑定测试分两层:默认值与映射逻辑直接单测构造器;环境绑定与松散匹配通过测试属性源启动上下文验证。校验违例场景断言启动/绑定异常。
原理流程
- 纯单测:直接 new 配置类断言默认值。
- 上下文测试:属性源提供键值,注入配置 Bean 断言绑定结果。
- 非法配置场景期望绑定/校验失败。
- 覆盖嵌套集合与枚举映射。
代码或图示
@SpringBootTest(properties = ["mail.port=2525"])
class MailPropsTest(private val props: MailProperties) {
@Test
fun `binds custom port`() {
assertEquals(2525, props.port)
}
}
常见误区
- 只在服务测试中间接验证配置:绑定错误定位慢。
- 枚举/集合绑定未覆盖:类型转换问题运行期才暴露。
追问
- 配置类校验违例如何测试启动失败?答:期望上下文启动抛绑定/校验异常,测试方式按 Spring 测试规则。
- 配置属性类是 data class 吗?答:是,不可变载体见 06.8.2.1 配置条目。
06.8.2.3-091 Spring Security 6.x DSL 基线与旧式配置如何迁移?
一句话结论
6.x 以 SecurityFilterChain Bean 与组件式配置为基线,旧 WebSecurityConfigurerAdapter 已移除;迁移时把适配器 configure(HttpSecurity) 方法改写为返回过滤器链的 @Bean 方法,DSL 块对应原链式配置。
概念解释
配置模型从继承适配器改为声明 Bean。每个过滤器链一个 Bean 方法,HttpSecurity 作为参数注入。DSL 与 Java 链式都可在 Bean 方法内使用;迁移重点是拆分多链与替换适配器入口。
原理流程
- 移除适配器继承。
- 按规则组拆成多个过滤器链 Bean。
http参数内复刻原授权/登录/CSRF 配置。- 启动验证过滤器顺序与规则。
代码或图示
// 旧:extends WebSecurityConfigurerAdapter { override fun configure(http) }
// 新:@Bean open fun filterChain(http: HttpSecurity): SecurityFilterChain
常见误区
- 保留适配器依赖:6.x 类不存在,编译失败。
- 多套规则挤在一个链:路径匹配与顺序难以维护。
追问
- 旧
authorizeRequests替换为什么?答:6.x 用authorizeHttpRequests,旧方法处于兼容地位;版本细节以官方文档为准(待确认)。 - 迁移后如何回归?答:401/403 测试 + 各角色端点冒烟。
06.8.2.3-092 kotlin-test/Kotest 与 Kotlin 2.x 版本如何对齐?
一句话结论
测试库版本需兼容 Kotlin 编译器 2.x 与 JUnit 平台;以 Boot BOM 与 Kotlin 兼容矩阵为准选择版本,协程测试库与协程核心版本一致,不单独追最新测试库。
概念解释
测试库依赖 Kotlin 元数据与编译器版本,过新或过旧都可能编译不兼容。版本链:Kotlin 编译器 ↔ kotlin-test ↔ coroutines-test ↔ mockk/JUnit 平台,统一在构建 BOM 管理。
原理流程
- 锁定 Kotlin 编译器版本。
- 选兼容的 kotlin-test 与协程测试版本。
- mockk/JUnit 版本按兼容表匹配。
- 编译与测试运行验证后固定版本。
代码或图示
// 兼容链:Kotlin 2.x <-> kotlin-test <-> coroutines-test <-> mockk
// 具体版本号以 BOM 与兼容矩阵为准(待确认)
常见误区
- mockk 单独升级到不兼容版本:模拟 final 类或协程桩件异常。
- 协程测试库与核心库版本错配:runTest 行为异常。
追问
- 版本冲突报什么现象?答:编译期元数据不兼容或运行期 NoSuchMethodError。
- 升级顺序?答:先 Kotlin/Boot 基线,再对齐测试库。
06.8.2.3-093 把 Java JUnit 测试迁移到 Kotlin 有哪些要点?
一句话结论
测试类改为 Kotlin 后用构造器注入替代字段注入,断言换 kotlin-test 或保留 AssertJ,mock 按栈选择 mockk;测试命名可用 backtick 风格,保留原有用例覆盖与断言意图,不逐行直译 Java 样板。
概念解释
迁移目标是可读的 Kotlin 测试,不是语法转换。依赖注入改构造器,桩件模型从 Mockito 迁 mockk(尤其 final 类),断言保留原校验强度;测试数据夹具顺势重构为工厂函数。
原理流程
- 复制测试用例与断言意图。
- 类改 Kotlin,依赖构造器注入。
- Mockito 桩件迁 mockk,协程方法用 coEvery。
- 断言库按团队选择,跑通原覆盖场景。
代码或图示
// Java: @Autowired private UserService service;
// Kotlin: 构造器参数 private val service: UserService
常见误区
- 直译保留字段注入与
@Mock字段:未利用 Kotlin 不可变优势。 - 迁移时弱化断言:只保留成功路径,拒绝路径丢失。
追问
- 能新旧测试共存吗?答:可以,按文件逐步迁移。
- 静态导入断言怎么处理?答:kotlin-test 顶层函数直接调用,不再需要静态导入。
06.8.2.3-094 测试覆盖率统计与 Kotlin 编译产物有什么注意点?
一句话结论
覆盖率工具基于字节码计数,Kotlin 合成构造、默认参数重载、属性访问器会产生额外字节码;覆盖率统计需包含测试源集,未覆盖的合成成员应识别为语言生成而非业务缺口。
概念解释
Kotlin 编译产出合成方法与重载,覆盖率报告中这些成员可能显示未覆盖。配置覆盖率工具排除生成代码或按源码映射解读;测试覆盖的是业务分支,不是每个合成字节码方法。
原理流程
- 编译产物含 Kotlin 合成成员。
- 覆盖率工具插桩字节码统计。
- 报告区分业务代码与生成代码。
- 按源码分支评估真实覆盖缺口。
代码或图示
// 覆盖率解读:data class 生成方法、默认参数重载、属性访问器不计入业务分支缺口
常见误区
- 追求覆盖率数字 100% 去写无意义测试:应覆盖业务分支与边界。
- 覆盖率工具不识别 Kotlin 元数据:报告行号映射错乱,需选支持 Kotlin 的工具配置。
追问
- 覆盖率工具有哪些?答:Jacoco 等,配置与报告形式按项目构建链;通用工程实践见 06.1。
- 默认参数分支要测吗?答:必填与默认回退两条路径按业务重要性覆盖。
06.8.2.3-095 本节有哪些需要实测核对的版本待确认项?
一句话结论
Security 6.x 方法级与 DSL 细节、DataJpaTest 与 mockk 集成方式、Kotlin 2.x 测试库兼容版本、响应式安全上下文 API、Testcontainers 集成坐标均需按项目实际版本核对,不凭记忆写死。
概念解释
版本敏感行为在不同小版本有差异。落地前列出待确认清单,用最小可运行示例验证:编译是否通过、运行期行为是否符合描述,再把确认结果回填文档。
原理流程
- 列出版本相关 API 与行为假设。
- 在目标 Boot/Spring/Kotlin 版本写验证示例。
- 记录实际行为与版本号。
- 文档中标注确认结论或保留待确认。
代码或图示
// 待确认:Security DSL 6.x 小版本差异、DataJpaTest mockk 集成、
// 响应式安全上下文读取 API、测试库兼容矩阵、Testcontainers 坐标
常见误区
- 把旧版本 API 写到新版本代码:编译/运行失败。
- 未验证就在文档写确定版本行为:误导后续维护。
追问
- 待确认项验证入口?答:Spring 参考文档版本快照 + 本地最小工程。
- 发现行为不符怎么办?答:以实测为准修正文档,标注实际版本基线。
06.8.2.3-096 场景:仓库扩展函数与自定义片段如何组合?
一句话结论
简单可空转换用仓库接口扩展函数,复杂动态查询放自定义片段实现;扩展调用片段或默认仓库方法,服务层只面向仓库接口,两类机制分工不重叠。
概念解释
派生/JPQL 方法表达固定条件,片段承载 Criteria/原生动态逻辑,扩展函数做结果适配。组合时扩展不写查询逻辑,片段不做 DTO 转换,边界清晰便于测试。
原理流程
- 主仓库接口继承基础仓库与片段接口。
- 片段实现注入 EntityManager 写动态查询。
- 扩展函数包装返回值为可空/DTO。
- 服务层调用统一仓库接口。
代码或图示
interface OrderRepository : JpaRepository<Order, Long>, OrderRepositoryCustom
fun OrderRepository.findLatestOrNull(customerId: Long): Order? =
search(customerId).firstOrNull()
常见误区
- 扩展函数里堆复杂 SQL:应下沉到片段。
- 片段直接返回 DTO:仓库层越界到接口模型。
追问
- 扩展函数能访问片段方法吗?答:接口继承后扩展可调用片段公开方法。
- 片段实现命名约定?答:接口名 + Impl,Spring Data 自动识别。
06.8.2.3-097 场景:按角色配置接口放行规则怎么落地?
一句话结论
先划公开路径、角色路径与兜底规则,精确规则前置、anyRequest 兜底;角色常量集中管理,hasRole 补前缀,测试覆盖匿名、普通角色、管理员三类访问结果。
概念解释
授权配置按资源分组:健康检查/登录放行,管理路径限管理员,业务路径登录即可。规则顺序与前缀约定明确,角色标识与用户加载侧保持一致,测试验证各身份状态码。
原理流程
- 枚举端点访问级别。
- DSL 按精确到宽泛声明规则。
- UserDetailsService 加载对应角色权限。
- 测试矩阵验证 200/401/403。
代码或图示
authorizeHttpRequests {
authorize("/health", permitAll)
authorize("/admin/**", hasRole("ADMIN"))
authorize(anyRequest, authenticated)
}
常见误区
- 公开路径写得过宽:误放行受保护接口。
- 角色前缀在加载侧与判断侧不一致:管理员也 403。
追问
- 细粒度权限替代角色?答:接口/资源级用 authority,角色仅做粗分;授权模型见 06.1。
- 规则冲突如何复查?答:导出路由清单与规则逐条比对,配合 401/403 测试。
06.8.2.3-098 场景:如何为协程服务层编写单元测试?
一句话结论
构造器注入 mockk 桩件,coEvery 打桩 suspend 依赖,runTest 内调用被测服务,coVerify 验证交互;不启动 Spring 上下文,断言业务结果、异常与调用次数。
概念解释
纯单元测试隔离服务层:依赖全部打桩,协程调度用测试环境。覆盖正常路径、降级、异常与参数校验,桩件只模拟必要调用,避免过度设定无关交互。
原理流程
- mockk 构造依赖桩件。
- coEvery 指定挂起方法返回/异常。
- runTest 内实例化服务并调用。
- 断言结果与 coVerify 交互次数。
代码或图示
@Test
fun `creates order with discount`() = runTest {
val repo = mockk<OrderRepository>()
coEvery { repo.save(any()) } returns sampleOrder
val service = OrderService(repo, pricing)
val result = service.create(command)
assertEquals(sampleOrder.id, result.id)
coVerify(exactly = 1) { repo.save(any()) }
}
常见误区
- 单测启动完整上下文:变慢且混入容器问题。
- 桩件未打桩的挂起方法返回 null:协程结果不符合预期。
追问
- 服务内并发子任务怎么测?答:runTest 等待作用域完成,断言全部子任务交互。
- 异常路径断言?答:
assertFailsWith包裹调用,验证桩件未执行写入。
06.8.2.3-099 场景:切片测试发现上下文加载过重如何排查?
一句话结论
列出切片上下文中的 Bean 清单,定位误装配的自动配置与多余控制器/仓库;用切片注解收窄范围、排除无关配置,桩件替换外部依赖,把上下文限制在被测层。
概念解释
测试启动慢往往是装了不需要的层。先看上下文 Bean 列表与启动条件,区分该装载的目标组件与误引入的客户端/中间件配置;逐层收窄到 Web/ JPA 对应切片。
原理流程
- 打印测试上下文 Bean 定义清单。
- 标注超出被测层的 Bean。
- 排除对应自动配置或收紧切片范围。
- 外部依赖用桩件,复测启动时间与上下文大小。
代码或图示
排查:Bean 清单 -> 误装配自动配置 -> 排除/收紧切片 -> 桩件替换 -> 复测上下文
常见误区
- 直接用
@SpringBootTest写本可切片的测试:上下文天然过重。 - 排除配置后被测依赖也缺失:按类型补回必要桩件。
追问
- 如何看自动配置报告?答:启动条件评估报告列出匹配/未匹配配置,通用自动配置见 06.2。
- 切片之间能否组合?答:按需要叠加 Web 与 JPA 切片能力,但保持最小装配原则。
06.8.2.3-100 综合:Kotlin + Spring Data + Security + 测试的落地清单是什么?
一句话结论
实体用普通类 + noarg/allopen + 可写状态字段,仓库返回可空适配;安全以过滤器链 Bean + DSL 配置规则,主体标识显式传递;测试用切片/单测分层,mockk 打桩协程依赖,每步用测试与启动验证兜底。
概念解释
清单把数据层、安全层、测试层的 Kotlin 特化约束收拢:持久化模型尊重 JPA 状态机,安全配置尊重过滤器链顺序,测试尊重分层隔离。通用 JPA/Security 原理不重复,本节只保留 Kotlin 落地要点。
原理流程
- 数据层:实体构造/映射/仓库适配按本节规则。
- 安全层:过滤器链 DSL、角色权限、异常入口与测试覆盖。
- 测试层:切片 + 单测分层,mockk/coEvery,runTest 验证协程。
- 版本基线核对,待确认项实测后回填。
代码或图示
// 落地骨架:实体普通类 + 仓库可空扩展 + 服务构造器注入 + 安全链 Bean + mockk 单测
常见误区
- 实体套 data class 图简洁:代理、相等性与懒加载问题集中爆发。
- 安全规则只写 happy path:拒绝路径无测试保护。
- 测试不分层:上下文重、断言混杂、定位困难。
追问
- 新增实体先检查什么?答:无参构造、可写字段、相等性/toString 边界、仓库返回可空适配。
- 新增接口先检查什么?答:规则归属角色/权限、主体参数显式传入、401/403 测试用例。
参考来源
- Spring Data JPA Reference Documentation — 实体映射、仓库派生查询、Specification 与投影机制。
- Spring Security Reference — 过滤器链、授权规则、方法安全与 Kotlin DSL 配置。
- Spring Framework Reference: Testing — 测试上下文、切片、MockMvc 与事务回滚机制。
- mockk 官方文档 — Kotlin 友好的 mock 库,final 类与挂起函数打桩验证。
- Kotlin 官方文档 — 语言空安全、data class、协程测试与标准库断言。
待整理清单
- [ ] 核对项目 Boot 3.2+ / Spring Security 6.x 小版本的 DSL 与方法安全支持清单
- [ ] 验证
@DataJpaTest与 mockk 桩件注册的集成方式与版本兼容性 - [ ] 确认 WebFlux 响应式安全上下文在协程链路中的读取 API(版本相关,待确认)
- [ ] 核对 kotlin-test、kotlinx-coroutines-test、mockk 与 Kotlin 2.x 的兼容矩阵版本
- [ ] 整理项目实体相等性/toString 规范与仓库可空扩展函数清单
- [ ] 补充 Testcontainers 与数据库迁移测试在 CI 环境的接入配置