Spring Boot 3升级后ANTLR版本冲突，如何强制使用ANTLR 3？

首先明确：无法强制Spring Boot 3使用ANTLR 3。因为Spring Boot 3配套的Spring Data JPA版本已经依赖ANTLR 4来实现HQL解析（报错中的HqlLexer就是Spring的核心类），强行替换ANTLR版本会导致Spring自身的JPA查询解析功能完全失效。

可行的解决方案如下：

1. 依赖隔离（推荐） #

使用构建工具的包重定位功能，将第三方提供的ANTLR 3生成库的包路径修改，避免和Spring的ANTLR 4包冲突。

以Maven为例，使用maven-shade-plugin对第三方jar包重新打包，修改ANTLR 3相关类的包路径：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.5.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <relocations>
                    <!-- 将ANTLR3的包路径重定位到自定义路径 -->
                    <relocation>
                        <pattern>org.antlr.v3</pattern>
                        <shadedPattern>com.yourcompany.shaded.antlr.v3</shadedPattern>
                    </relocation>
                </relocations>
            </configuration>
        </execution>
    </executions>
</plugin>

打包后，项目中同时存在重定位后的ANTLR 3类和Spring依赖的ANTLR 4类，两者互不干扰。

2. 推动第三方库升级 #

联系提供该ANTLR 3生成jar包的团队，请求他们将生成代码的ANTLR版本升级到4.x，从根源上消除版本冲突问题。

3. 排查依赖树确认冲突源 #

先执行Maven命令查看完整依赖树，确认是否有其他依赖意外引入了不兼容的ANTLR版本：

mvn dependency:tree -Dincludes=org.antlr

如果发现有多余的ANTLR依赖，可以通过<exclusions>标签排除，但注意：不能排除Spring Data JPA依赖的ANTLR 4，否则Spring的HQL解析会失效。

内容的提问来源于stack exchange，提问作者Mohammed Housseyn Taleb