Jenkins构建依赖Tomcat Servlet的Java SOAP服务遇IO目录扫描错误

一、解决ANT构建找不到Tomcat依赖的核心思路 #

不需要在Jenkins机器安装完整Tomcat，只需要提取构建必需的Tomcat依赖JAR即可：

• 从任意Tomcat安装包的lib目录中，复制构建需要的JAR（比如servlet-api.jar、jsp-api.jar等）到Jenkins机器的独立目录，例如/opt/tomcat-build-deps/lib。
• 修改ANT构建文件build.xml，将该目录加入项目classpath：

<path id="project.classpath">
    <!-- 保留原有其他依赖配置 -->
    <fileset dir="/opt/tomcat-build-deps/lib">
        <include name="*.jar"/>
    </fileset>
</path>

这种方式既满足构建依赖需求，又避免了安装完整Tomcat带来的冗余和权限问题。

二、解决Jenkins执行ANT时的IO扫描错误问题 #

控制台能运行但Jenkins报错，本质是Jenkins系统用户无Tomcat目录访问权限，按以下步骤处理：

1. 确认Jenkins运行用户：执行ps aux | grep jenkins，通常默认用户为jenkins。
2. 检查Tomcat lib目录权限：执行ls -ld <path to TOMCAT_HOME>/lib，查看目录的所属用户/组及权限。
3. 权限修复方案：
   • 方案一（推荐）：将Jenkins用户加入Tomcat目录所属用户组，例如usermod -aG tomcat jenkins，然后重启Jenkins服务：systemctl restart jenkins。
   • 方案二：临时开放目录读权限（不推荐长期使用）：

     chmod o+rx <path to TOMCAT_HOME>/lib
     chmod o+r <path to TOMCAT_HOME>/lib/*.jar
     

额外优化建议 #

如果可以调整构建工具，建议用Maven/Gradle替代ANT，直接从中央仓库拉取依赖并设置provided scope（因为运行时依赖由Tomcat提供），例如Maven配置：

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

这种方式彻底摆脱对本地Tomcat依赖的依赖，构建流程更标准化。

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