SpringBoot3升级后antlr版本冲突致ODL-Yang解析异常求助

核心问题分析 #

你遇到的异常本质是Antlr 4.x版本间的ATN（增强转移网络）序列化格式不兼容：YangParser依赖的Antlr 4.7.1生成的ATN版本为3，而Hibernate引入的Antlr 4.10.1要求的ATN版本为4，直接导致反序列化失败。

可行解决方案 #

1. 优先升级YangTools版本 #

最稳妥的解决方式是升级odl-yangtools-yang-parser到兼容Antlr 4.10+的版本。YangTools的高版本（如2.x及以上）通常会同步升级Antlr依赖至4.10+，这样就能和SpringBoot3自带的Hibernate依赖的Antlr版本对齐，从根源消除冲突。

2. 尝试降级Antlr版本至4.7.1（需验证兼容性） #

如果无法升级YangTools，可以强制将项目中的antlr4-runtime版本锁定为4.7.1，覆盖Hibernate的依赖版本。注意：SpringBoot3默认集成的Hibernate ORM 6.x可能依赖Antlr 4.10的新特性，降级后必须全面测试Hibernate核心功能（如HQL解析、实体映射、缓存等），避免引发新的兼容性问题。

Maven配置示例：

在pom.xml的dependencyManagement中强制指定版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.antlr</groupId>
            <artifactId>antlr4-runtime</artifactId>
            <version>4.7.1</version>
        </dependency>
    </dependencies>
</dependencyManagement>

Gradle配置示例：

configurations.all {
    resolutionStrategy.force 'org.antlr:antlr4-runtime:4.7.1'
}

3. 类隔离方案（复杂度较高） #

如果前两种方案都不可行，可以通过类隔离让两个依赖使用各自的Antlr版本。使用Maven Shade插件或Gradle Shadow插件，将YangTools及其依赖的Antlr 4.7.1的包路径重命名（比如把org.antlr改为com.yang.antlr），实现两个版本的Antlr在项目中并存，互不干扰。

Maven Shade插件配置示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.4.1</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <relocations>
                            <relocation>
                                <pattern>org.antlr</pattern>
                                <shadedPattern>com.yang.antlr</shadedPattern>
                            </relocation>
                        </relocations>
                        <artifactSet>
                            <includes>
                                <include>org.opendaylight.yangtools:*</include>
                                <include>org.antlr:antlr4-runtime</include>
                            </includes>
                        </artifactSet>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

方案优先级建议 #

1. 优先尝试升级YangTools版本，这是最无风险的解决方案；
2. 若升级不可行，再尝试降级Antlr版本并严格测试Hibernate功能；
3. 类隔离作为最后备选方案，适合必须保留两个版本依赖的场景。

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