1. 构建环境准备与依赖

Livy 0.7.1 编译同样强依赖 Bigtop 体系，强烈建议直接在官方 Bigtop 容器或预设环境下完成，极大减少环境不一致导致的构建失败。

环境组件	推荐版本	安装参考
JDK	1.8	ONEKEY——安装JDK1.8
Maven	3.8.4	ONEKEY——安装Maven3.8.4
Gradle	内嵌于 Bigtop	ONEKEY——安装Gradle5.6.4

提示

如未配置上述环境，可参考本站 JDK、Maven、Gradle 文档。不仅有详细安装说明，还附带一键安装脚本与离线包下载，覆盖主流运维场景，极大提升稳定性与复现度。

2. 源码包准备与离线编译建议

Livy 的源码包建议提前下载，默认存放路径为 /opt/modules/bigtop/dl/livy-0.7.1.zip，首次构建会自动检测，缺失时自动尝试联网下载。

警告

企业云环境/内网环境建议务必提前下载所有源码和依赖包，否则编译过程中网络波动或墙代理问题易致失败。

3. 一键构建命令与参数说明 推荐

进入 Bigtop 根目录后，直接执行如下命令：

gradle livy-rpm -PparentDir=/usr/bigtop -Dbuildwithdeps=true -PpkgSuffix -d

如果没有下载过，会自动触发下载

参数	作用说明
-PparentDir	指定 Bigtop 根路径，推荐必填
-Dbuildwithdeps=true	强制自动拉取全部依赖组件，保证依赖完整
-PpkgSuffix	自定义包名后缀，选填
-d	输出详细调试日志，有助问题定位

注意

务必确认当前 JAVA_HOME、M2_HOME 等变量已正确指向实际路径，避免依赖找不到。

4. 编译流程与关键日志解析

执行 gradle 任务后，Bigtop 会自动串联底层脚本与 Maven 任务，核心日志示例：

+ STATUS=0
+ '[' 0 -ne 0 ']'
+ cd livy-0.7.1
+ /usr/bin/chmod -Rf a+rX,u+w,g-w,o-w .
+ echo 'Patch #0 (patch0-python-executable-version.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
Patch #0 (patch0-python-executable-version.diff):
patching file python-api/pom.xml
+ echo 'Patch #1 (patch1-LIVY-756-0.7.1.diff):'
Patch #1 (patch1-LIVY-756-0.7.1.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file README.md
patching file assembly/assembly.xml
patching file assembly/pom.xml
patching file client-common/pom.xml
patching file client-common/src/main/java/org/apache/livy/client/common/Serializer.java
patching file core/scala-2.12/pom.xml
patching file core/src/test/scala/org/apache/livy/LivyBaseUnitTestSuite.scala
patching file coverage/pom.xml
patching file examples/src/main/scala/org/apache/livy/examples/WordCountApp.scala
patching file integration-test/pom.xml
patching file integration-test/src/test/resources/rtest.R
patching file integration-test/src/test/scala/org/apache/livy/test/InteractiveIT.scala
patching file integration-test/src/test/spark2/scala/Spark2JobApiIT.scala
patching file pom.xml
patching file repl/pom.xml
patching file repl/scala-2.11/pom.xml
patching file repl/scala-2.11/src/main/scala/org/apache/livy/repl/SparkInterpreter.scala
patching file repl/scala-2.12/pom.xml
patching file repl/scala-2.12/src/main/scala/org/apache/livy/repl/SparkInterpreter.scala
patching file repl/scala-2.12/src/test/scala/org/apache/livy/repl/SparkInterpreterSpec.scala
patching file repl/src/main/scala/org/apache/livy/repl/Session.scala
patching file repl/src/test/scala/org/apache/livy/repl/SQLInterpreterSpec.scala
patching file rsc/pom.xml
patching file rsc/src/main/java/org/apache/livy/rsc/driver/SparkEntries.java
patching file rsc/src/main/java/org/apache/livy/rsc/rpc/KryoMessageCodec.java
patching file scala-api/scala-2.12/pom.xml
patching file scala-api/src/main/resources/build.marker
patching file scala-api/src/main/scala/org/apache/livy/scalaapi/ScalaJobHandle.scala
patching file server/pom.xml
patching file server/src/main/scala/org/apache/livy/server/SessionServlet.scala
patching file server/src/main/scala/org/apache/livy/server/interactive/InteractiveSession.scala
patching file server/src/main/scala/org/apache/livy/utils/LivySparkUtils.scala
patching file server/src/test/scala/org/apache/livy/server/BaseJsonServletSpec.scala
patching file server/src/test/scala/org/apache/livy/server/SessionServletSpec.scala
patching file server/src/test/scala/org/apache/livy/server/batch/BatchServletSpec.scala
patching file server/src/test/scala/org/apache/livy/server/batch/BatchSessionSpec.scala
patching file server/src/test/scala/org/apache/livy/server/interactive/InteractiveSessionServletSpec.scala
patching file server/src/test/scala/org/apache/livy/server/interactive/InteractiveSessionSpec.scala
patching file server/src/test/scala/org/apache/livy/server/interactive/JobApiSpec.scala
patching file server/src/test/scala/org/apache/livy/server/interactive/SessionHeartbeatSpec.scala
patching file server/src/test/scala/org/apache/livy/server/recovery/FileSystemStateStoreSpec.scala
patching file server/src/test/scala/org/apache/livy/server/recovery/SessionStoreSpec.scala
patching file server/src/test/scala/org/apache/livy/server/recovery/StateStoreSpec.scala
patching file server/src/test/scala/org/apache/livy/server/recovery/ZooKeeperStateStoreSpec.scala
patching file server/src/test/scala/org/apache/livy/sessions/SessionManagerSpec.scala
patching file server/src/test/scala/org/apache/livy/utils/LivySparkUtilsSuite.scala
patching file server/src/test/scala/org/apache/livy/utils/SparkYarnAppSpec.scala
patching file test-lib/src/main/java/org/apache/livy/test/jobs/SQLGetTweets.java
patching file thriftserver/server/src/main/scala/org/apache/livy/thriftserver/types/DataTypeUtils.scala
patching file thriftserver/server/src/test/scala/org/apache/livy/thriftserver/ThriftServerSuites.scala
patching file thriftserver/session/pom.xml
patching file thriftserver/session/src/test/java/org/apache/livy/thriftserver/session/ColumnBufferTest.java
Patch #2 (patch2-LIVY-COMPILE-FAST.diff):
+ echo 'Patch #2 (patch2-LIVY-COMPILE-FAST.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file pom.xml
+ exit 0
Executing(%build): /bin/sh -e /var/tmp/rpm-tmp.KRBccB
+ umask 022
+ cd /opt/modules/bigtop/build/livy/rpm//BUILD
+ cd livy-0.7.1
+ bash /opt/modules/bigtop/build/livy/rpm/SOURCES/do-component-build
++ dirname /opt/modules/bigtop/build/livy/rpm/SOURCES/do-component-build
+ . /opt/modules/bigtop/build/livy/rpm/SOURCES/bigtop.bom
++ ZOOKEEPER_VERSION=3.5.9
++ HADOOP_VERSION=3.3.4
++ HBASE_VERSION=2.4.13
++ HIVE_VERSION=3.1.3
++ TEZ_VERSION=0.10.1
++ OOZIE_VERSION=5.2.1
++ SOLR_VERSION=8.11.2
++ SPARK_VERSION=3.5.5
++ FLINK_VERSION=1.17.2
++ PHOENIX_VERSION=5.1.2
++ BIGTOP_GROOVY_VERSION=2.5.4
++ BIGTOP_UTILS_VERSION=3.2.0-SNAPSHOT
++ BIGTOP_SELECT_VERSION=3.2.0-SNAPSHOT
++ BIGTOP_JSVC_VERSION=1.2.4
++ ALLUXIO_VERSION=2.8.0
++ KAFKA_VERSION=2.8.1
++ YCSB_VERSION=0.17.0
++ ZEPPELIN_VERSION=0.10.1
++ GPDB_VERSION=5.28.5
++ AMBARI_VERSION=2.7.5
++ BIGTOP_AMBARI_MPACK_VERSION=2.7.5
++ LIVY_VERSION=0.7.1
++ RANGER_VERSION=2.4.0
++ SQOOP_VERSION=1.4.7
++ REDIS_VERSION=7.4.0
++ DOLPHINSCHEDULER_VERSION=3.2.2
++ DORIS_VERSION=2.1.7
++ NIGHTINGALE_VERSION=7.7.2
++ CATEGRAF_VERSION=0.4.1
++ VICTORIAMETRICS_VERSION=1.109.1
++ CLOUDBEAVER_VERSION=24.3.3
++ CELEBORN_VERSION=0.5.3
++ OZONE_VERSION=1.4.1
++ IMPALA_VERSION=4.4.1
++ TRINO_VERSION=474
++ HUDI_VERSION=1.0.1
++ PAIMON_VERSION=1.1.0
++ ATLAS_VERSION=2.4.0
++ SUPERSET_VERSION=4.1.2
++ JDK_VERSION=1.8
++ SCALA_VERSION=2.12.13
+ LIVY_BUILD_OPTS='-Drat.skip=true                  -DskipTests                  -Dskip=true                  -DskipITs=true                  -Dscala-2.12.version=2.12.13
-Dscala-2.12.version=2.12.15                  -Dzookeeper.version=3.5.9                  -Dhadoop.version=3.3.4                  -Dspark.scala-2.12.version=3.5.5                  -Pspark-3
.0'
+ mvn install -Drat.skip=true -DskipTests -Dskip=true -DskipITs=true -Dscala-2.12.version=2.12.13 -Dscala-2.12.version=2.12.15 -Dzookeeper.version=3.5.9 -Dhadoop.version=3.3.4 -Dspark.scal
a-2.12.version=3.5.5 -Pspark-3.0

成功时，产物将归档到 output 目录，详见下节。编译日志片段

5. 编译产物与输出目录

最终产物在如下路径：

/opt/modules/bigtop/output/livy/noarch

例如：

drwxr-xr-x 2 root root     4096 Jun  8 09:03 .
drwxr-xr-x 3 root root     4096 Jun  8 09:03 ..
-rw-r--r-- 1 root root 67143188 Jun  8 09:03 livy-0.7.1-1.el8.noarch.rpm
[root@rocky8 noarch]# pwd
/opt/modules/bigtop/output/livy/noarch
[root@rocky8 noarch]#

6. 常见问题与后续集成

Livy 包二次开发与适配过程常需涉及如下修改（参考实际业务需求可按需调整）：

按顺序修改即可