Spring Boot+QueryDSL调用MySQL UUID_SHORT()函数失败的原因排查

使用MySQL 8.0（实际为Amazon Aurora数据库）结合Spring Boot/QueryDSL开发时，调用MySQL的UUID_SHORT()函数遇到异常：

org.springframework.dao.InvalidDataAccessApiUsageException: org.hibernate.QueryException: No data type for node: org.hibernate.hql.internal.ast.tree.MethodNode

相关源码 #

public class MyRepository extends MySQL8Dialect {
  ...

  // 注册未被识别的数据库函数（此处为'uuid_short'）
  public MyRepository() {
    super();
    registerFunction("uuid_short", new NoArgSQLFunction("uuid_short", StandardBasicTypes.STRING));
  }

  public String getUuidShort() {
    // 场景1：原生查询正常工作
    return entityManager.createNativeQuery("SELECT uuid_short()")
      .getSingleResult()
      .toString();

    // 场景2：JPAQueryFactory调用失败
    return jpaQueryFactory.select(Expressions.stringTemplate("uuid_short()"))
      .from(myEntity)
      .fetchOne();

    // 场景3：调用MySQLDialect中已注册的函数（sysdate()）正常工作
    return jpaQueryFactory.select(Expressions.stringTemplate("sysdate()"))
      .from(myEntity)
      .fetchOne();
  }
}

原因分析 #

1. 自定义方言未被Hibernate加载
   你把函数注册逻辑写在了MyRepository类中，但这个类继承MySQL8Dialect后并没有被Hibernate当作方言类使用。Hibernate需要通过配置明确指定自定义方言类，否则你在构造方法里注册的uuid_short函数根本不会生效，QueryDSL生成HQL时找不到对应函数的定义，就会抛出类型节点错误。

2. QueryDSL调用方式错误
   即使方言注册正确，你用Expressions.stringTemplate("uuid_short()")的写法，QueryDSL会直接把这段内容当作原生HQL片段处理，不会关联到Hibernate已注册的函数。而sysdate()能正常工作是因为它已经在默认的MySQLDialect中注册过，HQL能识别这个函数。

3. Aurora兼容性影响（次要）
   Amazon Aurora虽兼容MySQL，但部分函数的底层处理可能和原生MySQL有细微差异，但这不是核心问题，核心还是函数注册未生效和调用方式不对。

修正方案 #

1. 独立定义自定义方言类 #

不要让Repository继承方言类，单独创建一个方言类：

public class CustomMySQL8Dialect extends MySQL8Dialect {
    public CustomMySQL8Dialect() {
        super();
        registerFunction("uuid_short", new NoArgSQLFunction("uuid_short", StandardBasicTypes.STRING));
    }
}

2. 配置Hibernate使用自定义方言 #

在application.properties中添加配置：

spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomMySQL8Dialect

（替换com.yourpackage为你实际的包路径）

3. 正确使用QueryDSL调用注册函数 #

修改JPAQueryFactory的调用代码，使用Expressions.function来调用已注册的函数：

return jpaQueryFactory.select(Expressions.function("uuid_short", String.class))
                      .from(myEntity)
                      .fetchOne();

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