Spring Boot 2+Neo4j 3.3.4+QueryDSL运行时属性不存在错误求助

我之前帮好几个开发者排查过和你完全类似的问题——Spring Boot 2 + JDK8 + Neo4j 3.3.4 + Spring Data Rest 集成 QueryDSL 时出现No property for type at runtime错误。这个问题大多和QueryDSL元数据生成、依赖版本不兼容或者Neo4j专属配置不到位有关，咱们一步步来解决：

1. 先锁死依赖版本的兼容性 #

你的技术栈组合对版本匹配要求很高，尤其是JDK8只能搭配QueryDSL 4.x系列（5.x及以上需要JDK11+），同时要和Spring Data Neo4j 2.x（适配Spring Boot 2）、Neo4j 3.3.4完全对齐。

Maven依赖示例 #

<!-- QueryDSL核心与Neo4j适配依赖 -->
<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-neo4j</artifactId>
    <version>4.4.0</version> <!-- 这个版本完美适配Spring Boot 2.x + Neo4j 3.3.4 -->
</dependency>
<!-- APT注解处理器，用于生成QueryDSL元数据类 -->
<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-apt</artifactId>
    <version>4.4.0</version>
    <scope>provided</scope>
</dependency>

Gradle依赖示例 #

dependencies {
    // 其他核心依赖...
    implementation "com.querydsl:querydsl-neo4j:4.4.0"
    annotationProcessor "com.querydsl:querydsl-apt:4.4.0:neo4j"
    annotationProcessor "org.springframework.data:spring-data-neo4j:2.1.14.RELEASE" // 适配Spring Boot 2.1.x的版本
}

2. 确保APT注解处理器正确配置 #

QueryDSL需要通过APT生成Q开头的元数据类（比如实体User对应QUser），如果这些类没生成或者生成错误，就会触发找不到属性的报错。

Maven插件配置 #

在pom.xml的<build>节点下添加APT插件，注意指定Neo4j专属的注解处理器：

<plugins>
    <plugin>
        <groupId>com.mysema.maven</groupId>
        <artifactId>apt-maven-plugin</artifactId>
        <version>1.1.3</version>
        <executions>
            <execution>
                <goals>
                    <goal>process</goal>
                </goals>
                <configuration>
                    <outputDirectory>target/generated-sources/java</outputDirectory>
                    <!-- 必须用Neo4j的注解处理器，不能用JPA的！ -->
                    <processor>org.springframework.data.neo4j.repository.support.Neo4jAnnotationProcessor</processor>
                </configuration>
            </execution>
        </executions>
    </plugin>
</plugins>

Gradle插件配置 #

plugins {
    id 'com.ewerk.gradle.plugins.querydsl' version '1.0.10'
}

querydsl {
    jpa = false // 禁用JPA模式，启用Neo4j
    neo4j = true
    querydslSourcesDir = 'src/main/generated' // 元数据类生成目录
}

3. 检查实体类与Repository的写法 #

• 实体类必须标注@NodeEntity注解，且属性要有正确的getter/setter（或者用Lombok的@Data简化）；
• Repository必须同时继承Neo4jRepository和QuerydslPredicateExecutor，不要继承错JPA相关的接口：

import org.springframework.data.neo4j.repository.Neo4jRepository;
import com.querydsl.core.types.Predicate;

public interface UserRepository extends Neo4jRepository<User, Long>, QuerydslPredicateExecutor<User> {
    // 自定义查询方法...
}

4. 清理重建，确保元数据类是最新的 #

有时候旧的Q类缓存会导致属性不匹配，执行以下操作：

• 清理项目：mvn clean（Maven）或gradle clean（Gradle）；
• 重新编译：mvn compile或gradle compileJava；
• 检查生成目录（比如target/generated-sources/java）下是否有对应实体的Q类，且类中的属性和实体完全一致。

5. 调试日志定位具体问题 #

如果以上步骤都没解决，开启调试日志看看具体是哪个属性找不到：
在application.properties中添加：

logging.level.org.springframework.data.neo4j=DEBUG
logging.level.com.querydsl=DEBUG

启动项目后，查看日志中关于QueryDSL初始化的部分，通常会明确指出缺失的属性或元数据类问题。

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