Hive_3.1.3 编译实战1.0.0+
# 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
1
执行该命令会自动下载
| 参数 | 作用说明 |
|---|---|
| -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...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
成功时，产物将归档到 output 目录，详见下节。编译日志片段
# 5. 编译产物与输出目录
最终产物在如下路径：
/opt/modules/bigtop/output/hive/noarch
1
例如：
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]#
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 6. 常见问题与后续集成
Hive 包二次开发与适配过程常需涉及如下修改（参考实际业务需求可按需调整）：