Sakai 20.x版本部署失败：sakai-portal-api模块部署中断求助

首先梳理下你的环境和核心问题：

• 运行环境：Ubuntu 20.04、Java 11.0.9.1、Maven 3.6.3、Tomcat 9
• 关键问题：执行部署命令时在sakai-portal-api模块无报错停止；添加-Dmaven.test.skip=true无效，切换到20.0稳定版后卡在"Sakai Component Manager"环节

下面是几个经过验证的可行解决方向：

1. 抓取隐藏的错误日志 #

当前最核心的痛点是没有错误输出，根本无法定位问题。用Maven的debug模式运行，强制打印所有执行细节：

sudo mvn clean install sakai:deploy -Dmaven.tomcat.home=/usr/share/tomcat9 -Dsakai.home=/usr/share/tomcat9/sakai -Djava.net.preferIPv4Stack=true -X

-X参数会输出每一步的执行日志，包括编译时的隐性异常、依赖拉取失败、权限不足等信息，这些是定位问题的关键。

2. 修复目录权限问题 #

用sudo运行Maven容易导致生成的文件/目录权限归root所有，后续Tomcat（通常以tomcat用户运行）无法访问，这是很多部署卡住的隐性原因：

• 先以普通用户身份完成编译：mvn clean install -Dmaven.test.skip=true
• 再用sudo执行部署：sudo mvn sakai:deploy -Dmaven.tomcat.home=/usr/share/tomcat9 -Dsakai.home=/usr/share/tomcat9/sakai
• 最后修复Tomcat目录权限：

sudo chown -R tomcat:tomcat /usr/share/tomcat9

3. 单独排查sakai-portal-api模块 #

把问题缩小到单个模块，避免整个 reactor 构建的干扰：

# 切换到sakai-portal-api模块目录
cd sakai-portal-api
# 单独编译这个模块，查看是否能成功
mvn clean install -X

如果单独编译失败，日志会直接告诉你具体错误（比如某个类编译失败、依赖缺失）；如果编译成功，再单独部署该模块：

mvn sakai:deploy -Dmaven.tomcat.home=/usr/share/tomcat9 -Dsakai.home=/usr/share/tomcat9/sakai -X

4. 解决稳定版卡在Component Manager的问题 #

切换到20.0稳定版后卡住，大概率是内存不足或依赖冲突导致：

• 增加Tomcat内存：在/usr/share/tomcat9/bin/setenv.sh（如果没有就新建）中添加：

export CATALINA_OPTS="-Xmx2048m -Xms1024m -XX:MaxMetaspaceSize=512m"

（注意Java 11已移除PermSize参数，替换为MaxMetaspaceSize）

• 清理Tomcat缓存：

sudo rm -rf /usr/share/tomcat9/work/Catalina
sudo rm -rf /usr/share/tomcat9/temp/*

• 强制更新依赖：避免本地缓存的旧版本依赖引发冲突：

mvn clean install -Dmaven.test.skip=true -U

5. 确认Java版本的编译配置 #

Sakai 20支持Java 11，但要确保maven-compiler-plugin的配置与Java版本匹配，检查项目根pom.xml中的插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <source>11</source>
        <target>11</target>
        <encoding>UTF-8</encoding>
    </configuration>
</plugin>

如果配置不匹配，可能导致编译时的隐性错误，表面无输出但实际构建失败。

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