求推荐编译时将POJO转换为AVRO Schema（avsc）的Maven插件

你之前用ReflectData.get().getSchema(User.class)是运行时在内存中生成Schema对象，没法在编译阶段输出.avsc文件。下面是两种靠谱的编译期生成方案：

方法一：使用Apache Avro Maven插件（推荐） #

1. 给你的POJO添加Avro反射注解，标记为AVRO记录：

import org.apache.avro.reflect.Record;
import org.apache.avro.reflect.Stringable;

@Record
public class User {
    private String username;
    @Stringable
    private Integer age;
    private String email;

    // 必须要有无参构造器，Avro反射需要
    public User() {}

    // getter和setter方法
    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }
    // ... 其他属性的getter/setter
}

2. 在pom.xml中配置Avro Maven插件，开启schema生成目标：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.avro</groupId>
            <artifactId>avro-maven-plugin</artifactId>
            <version>1.11.3</version> <!-- 使用最新稳定版 -->
            <executions>
                <execution>
                    <id>schema-generate</id>
                    <phase>compile</phase> <!-- 绑定到编译阶段 -->
                    <goals>
                        <goal>schema-generate</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <sourceDirectory>${project.basedir}/src/main/java</sourceDirectory>
                <outputDirectory>${project.basedir}/src/main/resources/avro/schemas</outputDirectory>
                <!-- 可选：设置生成的Schema命名空间 -->
                <namespace>com.yourcompany.avro</namespace>
            </configuration>
        </plugin>
    </plugins>
</build>

<dependencies>
    <dependency>
        <groupId>org.apache.avro</groupId>
        <artifactId>avro</artifactId>
        <version>1.11.3</version>
    </dependency>
</dependencies>

执行mvn compile后，插件会自动扫描带@Record注解的POJO，在指定的outputDirectory下生成对应的.avsc文件。

方法二：使用Avro注解处理器 #

如果不想绑定Maven插件的特定目标，可以用注解处理器在编译时自动生成Schema：

1. 给POJO添加同方法一的@Record注解。
2. 在pom.xml中配置注解处理器路径：

<dependencies>
    <dependency>
        <groupId>org.apache.avro</groupId>
        <artifactId>avro</artifactId>
        <version>1.11.3</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.apache.avro</groupId>
                        <artifactId>avro-compiler</artifactId>
                        <version>1.11.3</version>
                    </path>
                </annotationProcessorPaths>
                <!-- 指定生成Schema的输出目录 -->
                <compilerArgs>
                    <arg>-Aavro.schema.output.dir=${project.basedir}/src/main/resources/avro/schemas</arg>
                </compilerArgs>
            </configuration>
        </plugin>
    </plugins>
</build>

执行mvn compile时，注解处理器会自动处理带@Record的POJO，生成.avsc文件到指定目录。

注意事项 #

• POJO必须包含无参构造器，否则Avro反射无法解析。
• 对于基本类型包装类（如Integer），可以用@Stringable注解让Schema生成对应的字符串类型，不添加则生成int类型。
• 建议使用与Avro依赖一致的版本，避免版本冲突。

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