kotlin 的密封接口（sealed interface）要求所有直接子类型必须在同一模块内显式声明，无法对外部 java 类（如 spring 的 `httpstatus`）直接实现密封接口，需通过封装方式间接集成。
在构建类型安全的错误处理体系时，我们常希望统一抽象不同来源的错误状态——例如，既包含自定义的 ErrorStatus 枚举，也想纳入 Spring Framework 提供的 org.springframework.http.HttpStatus。此时，自然会考虑使用 sealed interface Error 作为顶层契约：
sealed interface Error
对 Kotlin 自定义类型，扩展密封接口非常直观：
enum class ErrorStatus(val code: Int, val reasonPhrase: String) : Error {
ELEMENT_NOT_FOUND(1404, "Element not found"),
UNKNOWN_ERROR(1000, "Unknown Error"),
}但 无法为 HttpStatus 直接添加 : Error 实现——原因有二：
- Java 类不可外部“重开放”实现新接口：Kotlin 密封接口的子类型必须是显式声明并直接继承/实现该密封类型的类或对象，而 HttpStatus 是已编译的 final Java 类（尽管非 final，但其源码不在当前模块），无法修改其声明；
- 密封类型的继承树必须封闭且可静态分析：Kotlin 编译器需在编译期穷举所有子类型以支持 when 穷尽检查，因此所有直接子类/对象/枚举必须与密封接口位于同一编译单元（module）中，且不能是外部库的类型。
✅ 正确解法：封装（Wrapper）
通过轻量级封装类桥接外部类型，使其符合密封接口契约：
// 普通数据类封装（推荐用于调试友好、需序列化等场景） data class HttpStatusError(val status: HttpStatus) : Error // 或更高效的 inline 值类封装（Kotlin 1.5+，零运行时开销，但仅限单属性且 JVM 平台） @JvmInline value class HttpStatusError(val status: HttpStatus) : Error
⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
- @JvmInline value class 要求构造参数为非-nullable 且不可变（val），且不能重写任何成员（除 toString/hashCode/equals 外）；
- 封装后，可通过 when 安全穷尽匹配：
fun handleError(error: Error) = when (error) { is ErrorStatus -> println("Custom: ${error.reasonPhrase}") is HttpStatusError -> println("HTTP: ${error.status.reasonPhrase}") } - 若需双向转换（如从 HttpStatus 构造 Error），可添加伴生对象工厂方法：
@JvmInline value class HttpStatusError(val status: HttpStatus) : Error { companion { fun from(status: HttpStatus): HttpStatusError = HttpStatusError(status) } }
总结：密封接口的设计哲学是“显式可控的类型集合”，而非动态适配任意类型。面对第三方类，封装不是妥协，而是保持类型安全、可维护性与 Kotlin 惯用法的最佳实践。
