SoapUI自动化测试环境下Groovy类配置与脚本引用问题排查及代码复用实现

作为自动化测试工程师，我太懂你这种想重构冗余脚本却踩坑的感觉了！咱们一步步来拆解并解决你的问题：

一、先搞清楚导入失败的核心原因 #

你遇到的导入问题，大概率是这几个细节没处理到位：

1. 包声明与文件夹结构不匹配 #

如果把folderN作为类的根包，那你所有Groovy类的开头必须声明对应包名。比如folderN下的fewClasses.groovy，开头要加：

package folderN

class fewClasses {
    // 你的工具方法
}

之后在脚本里导入时，就要写import folderN.fewClasses，结构和包名必须完全对应，不然JVM找不到类。

2. 编译后的类不在SoapUI/Maven的类路径里 #

不管是手动用groovyc编译，还是用Maven管理，编译后的.class文件必须被测试运行时（SoapUI或Maven）识别：

• 手动编译的话，你得把.class所在目录手动加到SoapUI的Classpath（File > Preferences > Java Settings > Add Folder），但这显然不符合你“无需额外操作”的目标；
• 更靠谱的方式是交给Maven自动管理类路径，后面会详细讲。

3. 手动编译的隐性坑 #

你用groovyc手动编译的.class文件如果提交到Git，大概率会被设为只读——这是Git的默认文件权限逻辑导致的。而且手动编译很容易出现依赖缺失、输出目录混乱的问题，完全没必要这么做，别把编译产物提交到Git仓库！

二、解决类文件只读的问题 #

直接把仓库里已有的.class文件删掉，然后在.gitignore里添加规则，避免后续误提交：

*.class
target/

这样既解决了只读问题，又能减少仓库体积，避免编译产物冲突。

三、终极方案：用Maven自动编译，实现团队无缝运行 #

既然你已经有pom.xml，那就用Maven Groovy插件来自动化处理编译和类路径配置，让团队成员clone仓库后直接就能运行测试。

1. 调整仓库结构（推荐标准结构，省心） #

把Groovy类和脚本放到Maven标准目录下，这样所有人一看就懂：

repo:
  - src/
    - main/
      - groovy/
        - folderN/  # 这里放你的Groovy类文件
    - test/
      - groovy/
        - folderM/  # 原来的脚本文件夹，包含folder1、folder2等
  - sourceSoapFile.xml
  - pom.xml

如果不想移动现有文件，也可以在插件里指定自定义目录，后面会提到。

2. 在pom.xml中配置Groovy编译插件 #

添加gmavenplus-plugin，让Maven自动编译Groovy类，同时确保SoapUI能访问到这些类：

<build>
  <plugins>
    <!-- Groovy编译插件 -->
    <plugin>
      <groupId>org.codehaus.gmavenplus</groupId>
      <artifactId>gmavenplus-plugin</artifactId>
      <version>1.13.1</version>
      <executions>
        <execution>
          <goals>
            <goal>addSources</goal>
            <goal>addTestSources</goal>
            <goal>compile</goal>
            <goal>compileTests</goal>
          </goals>
        </execution>
      </executions>
      <dependencies>
        <dependency>
          <groupId>org.codehaus.groovy</groupId>
          <artifactId>groovy-all</artifactId>
          <!-- 必须和SoapUI使用的Groovy版本一致，比如SoapUI 5.7.0对应2.4.21 -->
          <version>2.4.21</version>
          <type>pom</type>
        </dependency>
      </dependencies>
      <!-- 如果不想用标准目录，这里自定义类和脚本的路径 -->
      <!-- <configuration>
        <sources>
          <source>
            <directory>${project.basedir}/folderN</directory>
            <includes>
              <include>**/*.groovy</include>
            </includes>
          </source>
        </sources>
        <testSources>
          <testSource>
            <directory>${project.basedir}/folderM</directory>
            <includes>
              <include>**/*.groovy</include>
            </includes>
          </testSource>
        </testSources>
      </configuration> -->
    </plugin>
    <!-- SoapUI Maven插件配置，确保能访问编译后的类 -->
    <plugin>
      <groupId>com.smartbear.soapui</groupId>
      <artifactId>soapui-maven-plugin</artifactId>
      <version>5.7.0</version>
      <configuration>
        <projectFile>sourceSoapFile.xml</projectFile>
        <!-- 把编译后的类目录加到类路径 -->
        <classpathElements>
          <classpathElement>${project.build.outputDirectory}</classpathElement>
        </classpathElements>
      </configuration>
    </plugin>
  </plugins>
</build>

注意：Groovy版本一定要和你SoapUI使用的版本匹配，否则会出现兼容性问题。

3. 在脚本中导入并使用类 #

现在你的类已经在正确的包路径下，脚本里直接导入调用即可：

import folderN.fewClasses

def tool = new fewClasses()
tool.yourCustomMethod()

4. 团队成员的操作 #

任何人clone仓库后，只需要执行一条命令：

mvn clean compile test

Maven会自动下载依赖、编译Groovy类、运行测试，完全不需要手动配置类路径或者编译。

如果用SoapUI GUI打开项目，只需要开启Maven集成（File > Preferences > Maven > Enable Maven Integration），加载项目的pom.xml，SoapUI会自动把编译后的类加到类路径里，直接运行脚本就行。

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