MQTT注解处理器生成类无法访问及通用调用问题求助

我之前开发注解处理器时也踩过“生成类无法访问”的坑，结合你做MQTT注解处理器的场景，给你梳理几个实用的排查方向和解决办法：

1. 检查生成类的访问权限与包路径 #

首先得确认生成的父类是不是具备可访问的条件：

• 访问修饰符要匹配：如果你的业务类是public，生成的父类也必须声明为public，不然子类没法访问它；
• 包路径要一致或可导入：生成类的包最好和标注@MQTT注解的业务类在同一个包下，要是跨包的话，记得在业务类里手动导入生成类；
• 举个正确的例子：如果业务类在com.example.mqtt.handlers，生成的父类代码应该是：

  package com.example.mqtt.handlers;
  
  public class GeneratedMoveForwardParent {
      // MQTT订阅逻辑和方法调度代码
  }
  

2. 配置构建工具识别生成目录 #

注解处理器生成的代码默认存在单独的目录，必须让Maven/Gradle把这个目录标记为源码根目录，不然编译时会找不到：

Maven配置 #

在pom.xml里给maven-compiler-plugin添加生成目录配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <generatedSourcesDirectory>${project.build.directory}/generated-sources/annotations</generatedSourcesDirectory>
    </configuration>
</plugin>

Gradle配置 #

在build.gradle（或build.gradle.kts）里添加源码目录声明：

sourceSets {
    main {
        java {
            srcDirs += 'build/generated/sources/annotationProcessor/java/main'
        }
    }
}

另外，IDE（比如IntelliJ）可能不会自动识别这个目录，右键生成目录 → Mark Directory as → Sources Root，让IDE把它当成源码目录处理。

3. 验证生成类的代码合法性 #

有时候生成的代码本身有语法错误，导致编译不通过，自然没法访问：

• 手动打开生成的.java文件，检查有没有拼写错误、缺少import语句（比如MQTT客户端的类）、方法签名不匹配的问题；
• 比如生成的父类里如果调用了业务类的moveForward方法，要确保方法签名完全一致，包括参数、返回值。

4. 确认业务类正确继承生成父类 #

你的业务类需要显式继承生成的父类，比如：

@MQTT(subscription = "/move/forward")
public class MobilityHandler extends GeneratedMoveForwardParent {
    public void moveForward() { 
        mobility.moveForward(); 
    }
}

如果你的注解处理器是打算自动生成继承关系，那得检查处理器代码有没有正确生成这个继承声明（不过通常注解处理器不会修改现有类，而是生成父类让你手动继承）。

5. 清理缓存并重新构建 #

构建缓存有时候会搞事情，导致生成的类没被正确编译：

• Maven执行：mvn clean compile
• Gradle执行：./gradlew clean build
  同时重启IDE，让它重新索引所有源码，避免IDE缓存导致的识别问题。

如果还是不行，开启注解处理器的调试日志，看看生成过程有没有异常：

• Maven编译时加-X参数：mvn clean compile -X，查看日志里注解处理器的执行细节；
• Gradle编译时加--info参数：./gradlew clean build --info，排查生成类时的报错信息。

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