1. 构建环境准备与依赖

Hive 3.1.3 编译同样强依赖 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. 源码包准备与离线编译建议

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

警告

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

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

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

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

执行该命令会自动下载

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

注意

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

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

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

> Task :hive-tar
Copy /opt/modules/bigtop/dl/apache-hive-3.1.3-src.tar.gz to /opt/modules/bigtop/build/hive/tar/apache-hive-3.1.3-src.tar.gz

> Task :hive-srpm
Copying common RPM SOURCES from: /opt/modules/bigtop/bigtop-packages/src/common/hive (excluding 3.1.3) to /opt/modules/bigtop/build/hive/rpm/SOURCES
No version-specific directory found at: /opt/modules/bigtop/bigtop-packages/src/common/hive/3.1.3
warning: File listed twice: hive-site.xml
Wrote: /opt/modules/bigtop/build/hive/rpm/SRPMS/hive_3_2_0-3.1.3-1.el8.src.rpm

> Task :hive-rpm
Installing /opt/modules/bigtop/output/hive/hive_3_2_0-3.1.3-1.el8.src.rpm
Executing(%prep): /bin/sh -e /var/tmp/rpm-tmp.4WDMFg
+ umask 022
+ cd /opt/modules/bigtop/build/hive/rpm//BUILD
+ cd /opt/modules/bigtop/build/hive/rpm/BUILD
+ rm -rf apache-hive-3.1.3-src
+ /usr/bin/gzip -dc /opt/modules/bigtop/build/hive/rpm/SOURCES/apache-hive-3.1.3-src.tar.gz
+ /usr/bin/tar -xof -
+ STATUS=0
+ '[' 0 -ne 0 ']'
+ cd apache-hive-3.1.3-src
+ /usr/bin/chmod -Rf a+rX,u+w,g-w,o-w .
+ echo 'Patch #0 (patch0-HIVE-22779.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
Patch #0 (patch0-HIVE-22779.diff):
patching file ql/src/test/org/apache/hadoop/hive/ql/stats/TestStatsUtils.java
patching file spark-client/src/main/java/org/apache/hive/spark/client/metrics/ShuffleWriteMetrics.java
patching file spark-client/src/main/java/org/apache/hive/spark/counter/SparkCounter.java
+ echo 'Patch #1 (patch1-HIVE-23190.diff):'
Patch #1 (patch1-HIVE-23190.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file llap-server/src/java/org/apache/hadoop/hive/llap/shufflehandler/IndexCache.java
+ echo 'Patch #2 (patch10-exclude-hadoop-shaded-client-via-spark.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
Patch #2 (patch10-exclude-hadoop-shaded-client-via-spark.diff):
patching file hcatalog/webhcat/svr/pom.xml
+ echo 'Patch #3 (patch11-HIVE-24083-webhcat-compatible-hadoop334.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
Patch #3 (patch11-HIVE-24083-webhcat-compatible-hadoop334.diff):
patching file hcatalog/webhcat/svr/src/main/java/org/apache/hive/hcatalog/templeton/Main.java
+ echo 'Patch #4 (patch12-HIVE-22205-branch-3.1.diff):'
Patch #4 (patch12-HIVE-22205-branch-3.1.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file accumulo-handler/pom.xml
patching file itests/hcatalog-unit/pom.xml
patching file itests/hcatalog-unit/src/test/java/org/apache/hive/hcatalog/hbase/ManyMiniCluster.java
patching file itests/hive-unit/src/test/java/org/apache/hadoop/hive/metastore/security/TestZooKeeperTokenStore.java
patching file itests/hive-unit/src/test/java/org/apache/hive/service/server/TestInformationSchemaWithPrivilege.java
patching file itests/qtest-accumulo/pom.xml
patching file itests/qtest/pom.xml
patching file itests/util/src/main/java/org/apache/hadoop/hive/accumulo/AccumuloTestSetup.java
patching file itests/util/src/main/java/org/apache/hadoop/hive/llap/LlapItUtils.java
patching file itests/util/src/main/java/org/apache/hadoop/hive/ql/QTestMiniClusters.java
patching file kafka-handler/pom.xml
patching file llap-server/pom.xml
patching file llap-server/src/test/org/apache/hadoop/hive/llap/daemon/MiniLlapCluster.java
patching file pom.xml
patching file ql/src/test/org/apache/hive/testutils/MiniZooKeeperCluster.java
patching file standalone-metastore/metastore-common/pom.xml
patching file standalone-metastore/metastore-server/pom.xml
patching file standalone-metastore/metastore-tools/metastore-benchmarks/pom.xml
patching file standalone-metastore/metastore-tools/pom.xml
patching file standalone-metastore/pom.xml
Hunk #3 succeeded at 332 (offset -5 lines).
patching file storage-api/pom.xml
patching file upgrade-acid/pre-upgrade/pom.xml
+ echo 'Patch #5 (patch2-HIVE-20201.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
Patch #5 (patch2-HIVE-20201.diff):
patching file hbase-handler/src/java/org/apache/hadoop/hive/hbase/HiveHBaseTableSnapshotInputFormat.java
Patch #6 (patch3-HIVE-21569.diff):
+ echo 'Patch #6 (patch3-HIVE-21569.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file druid-handler/pom.xml
patching file druid-handler/src/java/org/apache/hadoop/hive/druid/serde/DruidScanQueryRecordReader.java
patching file itests/qtest-druid/pom.xml
patching file llap-common/src/java/org/apache/hadoop/hive/llap/AsyncPbRpcProxy.java
patching file llap-server/src/java/org/apache/hadoop/hive/llap/daemon/impl/AMReporter.java
patching file llap-server/src/java/org/apache/hadoop/hive/llap/daemon/impl/LlapTaskReporter.java
patching file llap-server/src/java/org/apache/hadoop/hive/llap/daemon/impl/TaskExecutorService.java
patching file llap-tez/src/java/org/apache/hadoop/hive/llap/tezplugins/LlapTaskSchedulerService.java
patching file pom.xml
patching file ql/src/java/org/apache/hadoop/hive/ql/exec/tez/WorkloadManager.java
patching file ql/src/test/org/apache/hadoop/hive/ql/exec/tez/SampleTezSessionState.java
patching file standalone-metastore/pom.xml
patching file storage-api/pom.xml
+ echo 'Patch #7 (patch4-HIVE-19316.diff):'
Patch #7 (patch4-HIVE-19316.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/ColumnsStatsUtils.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/aggr/DateColumnStatsAggregator.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/aggr/DecimalColumnStatsAggregator.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/aggr/DoubleColumnStatsAggregator.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/aggr/LongColumnStatsAggregator.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/aggr/StringColumnStatsAggregator.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/cache/DateColumnStatsDataInspector.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/cache/DecimalColumnStatsDataInspector.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/cache/DoubleColumnStatsDataInspector.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/cache/LongColumnStatsDataInspector.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/cache/StringColumnStatsDataInspector.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/merge/DateColumnStatsMerger.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/merge/DecimalColumnStatsMerger.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/merge/DoubleColumnStatsMerger.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/merge/LongColumnStatsMerger.java
patching file standalone-metastore/src/main/java/org/apache/hadoop/hive/metastore/columnstats/merge/StringColumnStatsMerger.java
+ echo 'Patch #8 (patch5-HIVE-25173-branch-3.1.diff):'
Patch #8 (patch5-HIVE-25173-branch-3.1.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file upgrade-acid/pom.xml
+ echo 'Patch #9 (patch6-HIVE-21777.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
Patch #9 (patch6-HIVE-21777.diff):
patching file service/pom.xml
+ echo 'Patch #10 (patch7-HIVE-22278-branch-3.1.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
Patch #10 (patch7-HIVE-22278-branch-3.1.diff):
patching file ql/pom.xml
patching file standalone-metastore/pom.xml
Hunk #1 succeeded at 276 (offset 22 lines).
+ echo 'Patch #11 (patch8-HIVE-22398-branch-3.1.diff):'
Patch #11 (patch8-HIVE-22398-branch-3.1.diff):
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
patching file common/src/java/org/apache/hadoop/hive/conf/HiveConf.java
patching file itests/hive-unit-hadoop2/src/test/java/org/apache/hive/jdbc/TestSchedulerQueue.java
patching file service/src/java/org/apache/hive/service/cli/session/HiveSessionImpl.java
patching file shims/0.23/src/main/java/org/apache/hadoop/hive/shims/Hadoop23Shims.java
patching file shims/common/src/main/java/org/apache/hadoop/hive/shims/SchedulerShim.java
patching file shims/common/src/main/java/org/apache/hadoop/hive/shims/ShimLoader.java
patching file shims/scheduler/src/main/java/org/apache/hadoop/hive/schshim/FairSchedulerShim.java
+ echo 'Patch #12 (patch9-exclude-reload4j.diff):'
+ /usr/bin/patch --no-backup-if-mismatch -p1 --fuzz=0
Patch #12 (patch9-exclude-reload4j.diff):
patching file standalone-metastore/src/assembly/bin.xml
+ exit 0
Executing(%build): /bin/sh -e /var/tmp/rpm-tmp.xohpJ4
+ umask 022
+ cd /opt/modules/bigtop/build/hive/rpm//BUILD
+ cd apache-hive-3.1.3-src
+ env DO_MAVEN_DEPLOY=false MAVEN_DEPLOY_SOURCE=false MAVEN_REPO_ID= MAVEN_REPO_URI= bash /opt/modules/bigtop/build/hive/rpm/SOURCES/do-component-build
++ dirname /opt/modules/bigtop/build/hive/rpm/SOURCES/do-component-build
+ . /opt/modules/bigtop/build/hive/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
+ HIVE_MAVEN_OPTS=' -Dhbase.version=2.4.13 -Dzookeeper.version=3.5.9 -Dhadoop.version=3.3.4 -DskipTests -Dtez.version=0.10.1 -Dspark.version=3.5.5 -Dscala.binary.version=2.12 -Dscala.versi
on=2.12.13 -Dguava.version=27.0-jre -Dcurator.version=4.2.0
'
++ dirname /opt/modules/bigtop/build/hive/rpm/SOURCES/do-component-build
+ . /opt/modules/bigtop/build/hive/rpm/SOURCES/maven_deploy.sh
++ '[' false = true ']'
+ '[' x86_64 = powerpc64le ']'
+ '[' x86_64 = aarch64 ']'
+ mvn -Dhbase.version=2.4.13 -Dzookeeper.version=3.5.9 -Dhadoop.version=3.3.4 -DskipTests -Dtez.version=0.10.1 -Dspark.version=3.5.5 -Dscala.binary.version=2.12 -Dscala.version=2.12.13 -Dg
uava.version=27.0-jre -Dcurator.version=4.2.0 clean install -Pdist
[INFO] Scanning for projects...

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

5. 编译产物与输出目录

最终产物在如下路径：

/opt/modules/bigtop/output/hive/noarch

例如：

drwxr-xr-x 2 root root      4096 Jun  7 11:08 .
drwxr-xr-x 3 root root      4096 Jun  7 11:08 ..
-rw-r--r-- 1 root root 289169728 Jun  7 11:08 hive_3_2_0-3.1.3-1.el8.noarch.rpm
-rw-r--r-- 1 root root    122968 Jun  7 11:08 hive_3_2_0-hbase-3.1.3-1.el8.noarch.rpm
-rw-r--r-- 1 root root    510140 Jun  7 11:08 hive_3_2_0-hcatalog-3.1.3-1.el8.noarch.rpm
-rw-r--r-- 1 root root      9428 Jun  7 11:08 hive_3_2_0-hcatalog-server-3.1.3-1.el8.noarch.rpm
-rw-r--r-- 1 root root  73631332 Jun  7 11:08 hive_3_2_0-jdbc-3.1.3-1.el8.noarch.rpm
-rw-r--r-- 1 root root      9500 Jun  7 11:08 hive_3_2_0-metastore-3.1.3-1.el8.noarch.rpm
-rw-r--r-- 1 root root      9528 Jun  7 11:08 hive_3_2_0-server2-3.1.3-1.el8.noarch.rpm
-rw-r--r-- 1 root root   3134708 Jun  7 11:08 hive_3_2_0-webhcat-3.1.3-1.el8.noarch.rpm
-rw-r--r-- 1 root root      9376 Jun  7 11:08 hive_3_2_0-webhcat-server-3.1.3-1.el8.noarch.rpm
[root@rocky8 noarch]# pwd
/opt/modules/bigtop/output/hive/noarch
[root@rocky8 noarch]#

6. 常见问题与后续集成

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

按顺序修改即可

• Hive版本适配改造（一）
• Hive版本适配改造（二）
• B-Hive版本适配改造（二）