这几天有小伙伴跟我反馈，有一个项目从 kotlin 1.2 升级到 kotlin 1.3 以后 Spring 项目无法启动，报 java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'xxx' method 错误,下面咱们一个个分析排查

没有引入任何其它变量，只是更改了 kotlin 的版本，猜测可能是编译出来的字节码不一样，出问题的函数如下。

kotlin 处理函数中 default 值的方法是生成一个静态的函数，比如下面的函数。

生成的部分字节码如下，主要看函数签名

通过阅读字节码，人肉翻译为 java 就是：

由此可以看到 kotlin 对于默认参数的处理办法就是用一个 mask，告诉后面的逻辑，特定位置的参数是否需要使用默认值。

回到原 getActivityGameModulePage 方法，这个方法上有两个注解，kotlin 在编译以后会新增一个 static 的方法

咦，这样 Spring 在扫描的时候，不会出问题吗？两个方法都标注了 @GetMapping("/page") 要处理，理论上不论是 Koltin1.2 还是 1.3 在处理的时候都会出问题才对。

遇事不决，上字节码

kotlin 1.2 编译出来的字节码

kotlin 1.3 编译出来的字节码

经过仔细对比，发现只有该方法的 flags 上面有一些区别，1.3 的字节码少了 ACC_BRIDGE 。

众所周知知， ACC_BRIDGE 是一种为了实现某些语言特性而由编译器自动生成的方法。除了 Kotlin，Java 自己本身在实现类型擦除等场景下也会用到 ACC_BRIDGE ，具体我这里就不展开了，大家可以去试一下。

是不是就是这个导致的问题呢？

我们来看我们当前用的什么 Spring 版本是如何处理方法的，通过调试我们进入到了这个方法

可以看到 Spring 4.3.10 版本判断是否是用户自己写的方法时的逻辑是方法不是 bridge 且方法不同于 Object 类中，因此现在情况就很明朗了。

在 kotlin1.2 中文，因为编译出的 getActivityGameByPage$default() 包含了 bridge，在 Spring 扫描的过程中就会被忽略掉，而 kotlin1.3 中，因为方法签名不包含 bridge，所以被当做了用户自己书写的方法，参与到扫描中，这样 controller 就冲突了，所以报了 Ambiguous mapping 错误。

那这么严重的问题，难道 kotlin 不解决吗？是的，kotlin 不解决，那就只能上层框架兼容了，Spring 在后续的版本中做了修复，增加了对 ACC_SYNTHETIC 的判断，修改的地方如下：

这样，在新版本的 Spring 中，就不存在这个问题了，升级以后果然解决了问题。

Kotlin 编译器源码探秘

有了实验的结果，反过来寻找原因就很简单了，找到原因 kotlin 1.2 的源码，然后翻一翻源码，马上找到了对应的逻辑。在 4 年前的一个 commit 中，有一个伙计干掉了 ACC_BRIDGE 标记。

对应的源码修改如下

Kotlin 新版逻辑

有小伙伴又试了 kotlin 1.4+，发现问题也消失了，这又引起了我的兴趣，看了一下字节码，发现新版本的 getActivityGameByPage$default() 中，已经没有了注解，这下从源头解决了问题。这下就弄明白了