Spring Data MongoDB Native Image 中 @Query 排序问题的分析与解决

问题背景

在使用 Spring Data MongoDB 构建原生镜像(Native Image)应用时，开发者可能会遇到一个特定问题：当在 Repository 接口中使用 @Query 注解并配合排序参数时，应用会抛出 Unexpected AOP exception 异常。这个问题在 MongoDB 的响应式(Reactive)和非响应式实现中都会出现。

错误现象

当开发者尝试在 Native Image 环境下执行带有排序的 @Query 查询时，会收到以下关键错误信息：

Caused by: java.lang.UnsupportedOperationException: CGLIB runtime enhancement not supported on native image. Make sure to include a pre-generated class on the classpath instead: org.springframework.data.mongodb.core.query.Query$$SpringCGLIB$$0

这个错误表明系统尝试在运行时通过 CGLIB 生成代理类，而这在 Native Image 环境中是不被支持的。

根本原因

这个问题源于 Spring Data MongoDB 在早期版本中对查询排序功能的实现方式。在 Native Image 环境中，GraalVM 不支持运行时字节码生成（如 CGLIB 代理），而 Spring Data 某些版本恰好依赖这种机制来处理查询排序。

解决方案

该问题已在 Spring Data MongoDB 的以下版本中得到修复：

• 4.2.9
• 4.3.3
• 4.4.0

对于使用 Spring Boot 的开发者，最简单的升级方案是：

1. 升级到 Spring Boot 3.3.9 或更高版本
2. 确保相关依赖（如 spring-boot-starter-data-mongodb-reactive）也随之更新

技术细节

在 Native Image 环境中，所有类必须在构建时已知，无法在运行时动态生成。早期版本的 Spring Data MongoDB 在实现排序功能时，会尝试为查询对象创建 CGLIB 代理，这违反了 Native Image 的基本限制。

修复后的版本改变了实现方式，不再依赖运行时字节码生成，而是使用更适合 Native Image 的替代方案来处理排序逻辑。

最佳实践

对于需要在 Native Image 中使用 Spring Data MongoDB 的开发者，建议：

1. 始终使用最新维护版本的 Spring Boot 和 Spring Data
2. 在迁移到 Native Image 前，全面测试所有数据访问逻辑
3. 关注官方文档中关于 Native Image 支持的特别说明
4. 考虑在开发早期就引入 Native Image 构建测试，避免后期发现兼容性问题

总结

Spring Data MongoDB 在 Native Image 环境中的 @Query 排序问题是一个典型的运行时与构建时行为差异导致的兼容性问题。通过升级到修复版本，开发者可以顺利解决这一问题，同时获得更好的 Native Image 支持。这也提醒我们在采用新技术栈时，保持依赖库更新和维护的重要性。