IntelliJ IDEA K2模式下Kotlin异常类在Spring Boot ControllerAdvice中出现类型不兼容误报

算力阿峰

2026-4-8

我之前升级到IntelliJ 2025版本的K2模式时，也碰到过一模一样的问题！这明显是K2模式下Kotlin插件对Spring @ExceptionHandler注解的类型解析出现了假阳性bug——毕竟项目能正常编译运行，说明代码逻辑完全没问题，只是IDE的静态分析抽风了。

给你几个亲测有效的解决办法：

改用Kotlin原生的类引用方式：把代码里的UnauthorizedException.class换成UnauthorizedException::class.java，K2模式对Kotlin风格的类引用兼容性更好，大概率能直接消除误报。修改后的代码示例：
```
@ResponseBody
@ResponseStatus(HttpStatus.UNAUTHORIZED)
@ExceptionHandler(UnauthorizedException::class.java)
public void handleUnauthorizedException(UnauthorizedException ex) {
    LOGGER.error(ex.getMessage());
}
```
添加显式类型强制转换：如果上面的方法没用，可以给异常类的::class加个强制类型转换，明确告诉IDE它是Throwable的子类：
```
@ExceptionHandler(UnauthorizedException::class as Class<out Throwable>)
```
临时回退到非K2模式：如果急着开发不想折腾，可以先切回旧版分析器——打开Settings > Languages & Frameworks > Kotlin > Compiler，把Kotlin compiler mode改成Legacy，重启IDE后误报应该就消失了。当然这只是临时方案，毕竟K2是未来的趋势。
向JetBrains提交bug：既然这是IDE的问题，建议去JetBrains官方问题追踪平台提交这个bug，附上你的IDE版本、Kotlin版本和代码示例，帮助官方更快修复这个兼容性小坑。