Micronaut JDBCRepository执行查询仅发送'true'语句的问题排查

核心问题定位 #

你的问题本质是复合主键场景下，数据访问框架的注解处理器或自动查询生成逻辑出现异常，错误生成了true这个无效SQL语句；而单主键场景下用JdbcOperations手动实现绕开了自动生成逻辑，因此可以正常工作。

可能的原因及解决步骤 #

1. 复合主键实体类注解配置不规范 #

复合主键需要正确使用@EmbeddedId或@IdClass，若注解配置错误，会导致框架无法解析实体结构，进而生成错误SQL：

• 若使用@EmbeddedId：

  @Embeddable
  public class UsageTrackingPK implements Serializable {
      private UUID userId;
      private UUID vendorId;
      // 必须实现构造器、equals、hashCode方法
  }
  
  @Entity
  public class UsageTracking {
      @EmbeddedId
      private UsageTrackingPK id;
      private LocalDateTime lastAccessed;
      // 其他字段及方法
  }
  

• 若使用@IdClass：

  public class UsageTrackingPK implements Serializable {
      private UUID userId;
      private UUID vendorId;
      // 必须实现构造器、equals、hashCode方法
  }
  
  @Entity
  @IdClass(UsageTrackingPK.class)
  public class UsageTracking {
      @Id
      private UUID userId;
      @Id
      private UUID vendorId;
      private LocalDateTime lastAccessed;
      // 其他字段及方法
  }
  

  注意：复合主键类必须实现Serializable，且正确重写equals和hashCode，否则框架无法识别主键结构。

2. Repository接口Upsert方法手动指定SQL #

避免依赖框架自动生成复合主键的Upsert语句，直接用@SqlUpdate指定原生PostgreSQL Upsert语法：

@Repository
public interface UsageTrackingRepository extends CrudRepository<UsageTracking, UsageTrackingPK> {
    @SqlUpdate("""
        INSERT INTO usage_tracking (user_id, vendor_id, last_accessed)
        VALUES (:userId, :vendorId, :lastAccessed)
        ON CONFLICT (user_id, vendor_id)
        DO UPDATE SET last_accessed = EXCLUDED.last_accessed
        """)
    void upsert(@Bind("userId") UUID userId, @Bind("vendorId") UUID vendorId, @Bind("lastAccessed") LocalDateTime lastAccessed);
}

3. 检查依赖与注解处理器配置 #

确保Micronaut Data相关依赖版本一致，注解处理器配置完整：

• 在pom.xml中确保依赖版本匹配：

  <dependency>
      <groupId>io.micronaut.data</groupId>
      <artifactId>micronaut-data-jdbc</artifactId>
      <version>${micronaut.data.version}</version>
  </dependency>
  <dependency>
      <groupId>io.micronaut.data</groupId>
      <artifactId>micronaut-data-processor</artifactId>
      <version>${micronaut.data.version}</version>
      <scope>provided</scope>
  </dependency>
  

• 确认maven-compiler-plugin中配置了正确的注解处理器路径：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.11.0</version>
      <configuration>
          <annotationProcessorPaths>
              <path>
                  <groupId>io.micronaut</groupId>
                  <artifactId>micronaut-inject-java</artifactId>
                  <version>${micronaut.version}</version>
              </path>
              <path>
                  <groupId>io.micronaut.data</groupId>
                  <artifactId>micronaut-data-processor</artifactId>
                  <version>${micronaut.data.version}</version>
              </path>
          </annotationProcessorPaths>
      </configuration>
  </plugin>
  

4. 改用JdbcOperations手动实现Repository #

沿用单主键场景下的可行方案，完全手动控制SQL生成：

@Repository
public class UsageTrackingRepositoryImpl implements UsageTrackingRepository {
    private final JdbcOperations jdbcOperations;

    public UsageTrackingRepositoryImpl(JdbcOperations jdbcOperations) {
        this.jdbcOperations = jdbcOperations;
    }

    @Override
    public void upsert(UUID userId, UUID vendorId, LocalDateTime lastAccessed) {
        String sql = """
            INSERT INTO usage_tracking (user_id, vendor_id, last_accessed)
            VALUES (?, ?, ?)
            ON CONFLICT (user_id, vendor_id)
            DO UPDATE SET last_accessed = EXCLUDED.last_accessed
            """;
        jdbcOperations.update(sql, userId, vendorId, lastAccessed);
    }
}

验证流程 #

1. 先校验复合主键实体类的注解、Serializable实现及equals/hashCode方法；
2. 尝试手动指定SQL的Repository方法，验证是否正常执行；
3. 若仍有问题，直接改用JdbcOperations手动实现逻辑。

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