Spring Boot迁移至Micronaut时Micronaut Data原生INSERT查询报无实现错误

Micronaut Data和Spring Data的实现机制存在核心差异：Spring Data对带@Query注解的方法不会在编译期做SQL语义解析，直接在运行时将SQL交给底层执行器运行；而Micronaut Data采用编译期生成Repository实现的机制，必须在编译阶段为每个Repository方法匹配对应的执行逻辑，否则就会抛出实现不存在的错误。
当前问题的触发逻辑：

• Micronaut Data内置的SQL语义解析器，仅能自动识别SELECT、UPDATE、DELETE三类原生语句的执行场景：SELECT类语句会自动匹配结果集映射逻辑，UPDATE、DELETE类无结果集的写操作会自动匹配事务内执行、返回影响行数的逻辑。
• 对于原生INSERT类语句，解析器无法自动识别其语义，在未收到显式指令时会判定没有可匹配的实现策略，因此触发No possible implementations found的编译错误。
• 前期排查结论是正确的：关联表my_entity_my_entity2无对应实体类并非问题触发原因，原生查询模式下Micronaut Data不会强制要求操作的表存在匹配的实体定义，该逻辑和Spring Data一致。

方案一：为插入方法显式标注执行语义（优先采用） #

在目标插入方法上添加@Execute注解，直接告知Micronaut Data编译逻辑，该方法为事务内直接执行的无返回结果写操作，不需要走查询结果映射流程。
修改后的代码示例：

import io.micronaut.data.annotation.Execute;

public interface MyEntityRepository extends CrudRepository<MyEntity, Integer> {

    @Query(value = "insert into my_entity_my_entity2 (id, id2)" +
            " values (:id, (select me2.id from my_entity2 os where me2.name = :name))", nativeQuery = true)
    @Execute // 默认采用REQUIRED事务传播行为，适配当前插入操作的场景要求
    void insertQueryExample(int id, String name);
}

添加该注解后，Micronaut Data在编译期会跳过对该方法的SQL语义解析，直接生成绑定SQL执行逻辑的实现代码，不会再触发编译错误。

方案二：调整方法返回值适配旧版本 #

如果使用的Micronaut Data版本低于3.0，无@Execute注解支持，可以将方法返回值从void修改为int（表示SQL执行影响的行数），部分旧版本的解析器会识别返回影响行数的写操作签名，自动匹配INSERT语句的执行逻辑。修改后代码：

@Query(value = "insert into my_entity_my_entity2 (id, id2)" +
        " values (:id, (select me2.id from my_entity2 os where me2.name = :name))", nativeQuery = true)
int insertQueryExample(int id, String name);

需要注意的是，该方案对低版本Micronaut Data有效，高版本仍推荐使用@Execute注解保证长期兼容性。

内容的提问来源于stack exchange，提问作者user51010