运行SparkSessionExtensionTest报错：找不到SqlBaseParserBaseVisitor类型

遇到的错误：

"not found: type SqlBaseParserBaseVisitor
class AstBuilder extends SqlBaseParserBaseVisitor[AnyRef] with SQLConfHelper with Logging {"

这个问题本质是SqlBaseParserBaseVisitor是ANTLR4根据Spark的SqlBase.g4语法文件自动生成的类，你的项目没有正确生成或识别这些类，以下是具体解决步骤：

• 检查ANTLR4 Maven插件配置
  必须在pom.xml中配置ANTLR4插件，确保开启visitor生成，并且语法文件路径、输出路径正确。示例配置如下（注意版本要和Spark依赖的ANTLR版本匹配，Spark3.x一般用4.9.2）：

  <plugin>
      <groupId>org.antlr</groupId>
      <artifactId>antlr4-maven-plugin</artifactId>
      <version>4.9.2</version>
      <executions>
          <execution>
              <goals>
                  <goal>antlr4</goal>
              </goals>
              <configuration>
                  <sourceDirectory>src/main/antlr4</sourceDirectory>
                  <outputDirectory>target/generated-sources/antlr4</outputDirectory>
                  <listener>false</listener>
                  <visitor>true</visitor> <!-- 必须开启，否则不会生成BaseVisitor类 -->
              </configuration>
          </execution>
      </executions>
  </plugin>
  

• 手动触发代码生成并编译
  运行Maven命令强制生成visitor类：

  mvn antlr4:antlr4
  

  之后执行编译：

  mvn compile
  

  在IntelliJ里可以右键pom.xml → Run Maven → 选择antlr4:antlr4，再执行compile。

• 让IntelliJ识别生成的代码目录
  找到target/generated-sources/antlr4目录，右键选择「Mark Directory as」→「Generated Sources Root」，这样IDE才会把生成的类当作源码处理。

• 确认ANTLR依赖范围正确
  确保ANTLR runtime依赖是compile范围，不要设为provided或test：

  <dependency>
      <groupId>org.antlr</groupId>
      <artifactId>antlr4-runtime</artifactId>
      <version>4.9.2</version>
  </dependency>
  

• 清理缓存重新构建
  执行mvn clean install清理旧的编译产物，重新生成代码并构建；同时在IntelliJ里点击「File」→「Invalidate Caches...」→「Invalidate and Restart」清除IDE缓存。

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