1. 先说清楚：Hive 到底是干嘛的，以及为什么非要用 MySQL

在讲安装步骤之前，我得先花点时间把 Hive 的本质讲透。因为大多数新手装 Hive 装到一半就放弃，根本原因不是命令敲错，而是压根不知道自己在装什么、为什么这么装。

Hive 的本质就是一个翻译官。它把你想写的 SQL 语句翻译成 MapReduce 或 Spark 任务，丢给底层的 Hadoop 集群去执行。也就是说，Hive 本身不存数据，数据在 HDFS 上，Hive 只是帮你把 SQL 变成分布式计算任务，顺便把“哪张表对应哪个 HDFS 目录、表有哪些字段、字段是什么类型”这类元数据信息记录下来。这些元数据存哪里？默认存在 Hive 自带的 Derby 数据库里，但 Derby 性能差、不支持并发，生产环境几乎没人用，所以大家都换成 MySQL。

这次教程选择 Hive 3.1.2，是因为这个版本是目前社区使用最广、稳定性最好的 3.x 版本之一。很多公司的老集群还在用它，网上能搜到的排错经验也最丰富，遇到问题基本都有现成的解决方案。如果你以后要装 Hive 4.x，流程也基本一致，只是个别配置项有变化。

还有一点必须提前说明：Hive 依赖于 Hadoop 环境，不是独立运行的程序。所以本篇教程默认你已经在 Ubuntu 上装好了 Hadoop，并且能正常启动 HDFS 和 YARN。如果你还没装 Hadoop，建议先去把 Hadoop 2.x 或 3.x 搭好，再回来折腾 Hive。我见过太多人跳过了 Hadoop 直接装 Hive，然后一脸疑惑地问为什么启动报错，这类问题基本都是环境没准备好。

这篇教程适合谁？适合已经在 Ubuntu 上装过 Hadoop、但是卡在 Hive 安装这一步的初学者，也适合第一次接触大数据组件、想完整走一遍环境搭建流程的在校学生。我会把每个步骤“为什么要这么做”也一并讲清楚，而不是只丢给你一串命令。

2. 安装前的三个关键决策

2.1 版本匹配：Hive 与 Hadoop、JDK 的兼容关系

很多人在装 Hive 时报错，查了半天发现是版本不兼容。这里我直接给你一张对照表，省得自己查：

这里特别强调一下 JDK 的问题。Hive 3.1.2 官方文档里写的是支持 Java 8 和 Java 11，但我实际测下来 Java 11 在启动时偶尔会出现莫名的反射报错，排查起来非常痛苦。所以别纠结，直接用 Java 8 最稳妥。

Hadoop 和 Hive 的版本匹配也值得注意。Hive 3.1.2 源码编译时是基于 Hadoop 2.7.7 的，但它对 Hadoop 3.x 的兼容性也做得很好。我身边有人用 Hadoop 3.3.4 + Hive 3.1.2 跑了半年没出问题，也有人用 Hadoop 2.7.7 配 Hive 3.1.2 照样稳。重点是 Guava 版本要处理对，这个坑我后面单独讲。

2.2 元数据库选型：Derby 与 MySQL 的本质区别

Hive 默认内嵌的 Derby 数据库，适合刚入门时快速体验一下 Hive 的 CLI。但只要你稍微用多一点，Derby 的问题就暴露了：

• 不支持并发访问，多个客户端同时连 Hive 时会直接报错
• 每次启动 Hive 都在当前目录生成一个 metastore_db 目录，换个目录启动就找不到之前的元数据
• 性能差，表的数量一多，查询元数据明显变慢

所以生产环境和正规的学习环境，无一例外都选 MySQL。MySQL 作为独立的外部元数据库，需要手动配置 metastore 连接信息，Hive 启动时通过 JDBC 连接 MySQL，读写所有表结构、分区信息、列类型等元数据。这也是本教程把 MySQL 安装方法一并讲清楚的原因——它是 Hive 的半个底座。

顺带提一句，MySQL 在这里的架构定位：Hive 客户端（CLI 或 JDBC 驱动）访问 HiveServer2，HiveServer2 再通过 Metastore 服务读写 MySQL 中的元数据。所以 MySQL 本身要允许远程连接，并且要建好对应的数据库和账号。

2.3 安装包下载方案：官网直接下还是用镜像加速

Hive 的安装包官方下载地址在 Apache 镜像站，但国内访问速度有时候不稳定。我推荐直接用清华镜像或华为云镜像，速度快还不容易断。MySQL 的安装更特殊一点，现在推荐直接用 MySQL 官方的 APT 仓库安装，而不是自己去下载 .deb 包，因为 APT 仓库会自动帮你处理依赖关系，省掉很多麻烦。

下载 Hive 时一定要下载apache-hive-3.1.2-bin.tar.gz这个二进制版本包，千万不要下源码包（src.tar.gz）。源码包需要自己编译，过程麻烦不说，还容易因为依赖版本问题失败。MySQL 则基于 8.0 版本，安装完成后记住 root 初始密码，后面会用到。

3. MySQL 安装配置全流程

3.1 通过官方 APT 仓库安装 MySQL 8.0

这一节是给还没装 MySQL 的读者准备的。如果你机器上已经有能用的 MySQL 5.7 或 8.0，可以直接跳到 3.3 节看如何建库授权，不必重新装一遍。

先把仓库加进来：

# 下载 MySQL APT 仓库配置包 wget https://dev.mysql.com/get/mysql-apt-config_0.8.24-1_all.deb # 安装仓库配置包（过程中会弹出图形界面，直接选择 OK 即可） sudo dpkg -i mysql-apt-config_0.8.24-1_all.deb # 更新软件源 sudo apt update

安装完仓库配置包后，MySQL 8.0 的安装就变得非常简单：

sudo apt install mysql-server

安装过程中会弹窗要求设置 root 密码。这里要提醒一句：MySQL 8.0 的默认认证插件是 caching_sha2_password，你设置的密码复杂度必须满足要求，否则会提示密码太弱。建议直接设置一个大小写字母加数字的组合密码，避免后续节外生枝。

安装完成后，验证一下 MySQL 服务状态：

systemctl status mysql

如果输出显示 active (running)，说明 MySQL 已经起来了。如果没起来，执行sudo systemctl start mysql手动启动，然后设置开机自启：

sudo systemctl enable mysql

3.2 初始化安全设置与远程连接授权

刚装好的 MySQL 其实还处于“裸奔”状态，需要做基本的安全加固。执行：

sudo mysql_secure_installation

按照提示依次操作：设置密码强度校验策略、移除匿名用户、禁止 root 远程登录、删除 test 数据库、重新加载权限表。这些选项全部选 YES 就行，没有坑。

接下来最关键的一步：创建 Hive 专用的数据库和账号。这一步很多人会忽略，直接用 root 账号去连 Hive 的 metastore，这在小规模测试环境勉强能跑，但存在两个问题：一是权限边界不清晰，二是如果 MySQL root 使用 caching_sha2_password 认证插件，Hive 连接时可能需要额外处理 SSL 或密码插件兼容。建议直接建独立账号。

-- 登录 MySQL mysql -u root -p -- 创建 Hive 元数据库 CREATE DATABASE hive_metastore CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 创建专用账号，允许任意主机连接 CREATE USER 'hive'@'%' IDENTIFIED BY 'Hive@123456'; -- 授权 GRANT ALL PRIVILEGES ON hive_metastore.* TO 'hive'@'%'; FLUSH PRIVILEGES;

注意字符集一定用 utf8mb4，不要用默认的 latin1。如果建库时用了 latin1，后面 Hive 表名或注释里有中文时，查出来全是乱码，排查起来很折腾。

MySQL 8.0 默认绑定地址是 127.0.0.1，也就是只允许本机连接。如果你的 Hive 和 MySQL 不在同一台机器，需要修改配置文件允许外部访问：

sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf

找到bind-address = 127.0.0.1，改成bind-address = 0.0.0.0，保存后重启：

sudo systemctl restart mysql

3.3 下载 MySQL JDBC 驱动并放置到 Hive 目录

这一步是连接 MySQL 和 Hive 的桥梁，漏掉必出错。Hive 3.1.2 与 MySQL 8.0 连接，需要mysql-connector-java8.x 版本的驱动包。注意 8.x 驱动和 5.x 驱动的类名不同：8.x 是com.mysql.cj.jdbc.Driver，5.x 是com.mysql.jdbc.Driver，用错了连不上。

下载方式：

# 下载 8.0.26 版本驱动，其他 8.x 版本也行 wget https://repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.26/mysql-connector-java-8.0.26.jar # 放到 Hive 的 lib 目录（等 Hive 解压之后执行，或者先建好目录） mkdir -p /opt/hive/lib cp mysql-connector-java-8.0.26.jar /opt/hive/lib/

如果你是通过 APT 仓库装的 MySQL，有时候系统会自带一个 Java 连接器包，但版本通常是 5.1.x，和 MySQL 8.0 连接有兼容性问题。所以别图省事，一定要手动下载 8.x 驱动。

4. Hive 3.1.2 安装配置完整实操

4.1 下载解压与环境变量配置

我习惯把软件统一安装到/opt目录下，这样目录结构清晰，也方便多版本切换。执行以下命令：

# 进入 /opt 目录 cd /opt # 下载 Hive 3.1.2 二进制包（用清华镜像加速） wget https://mirrors.tuna.tsinghua.edu.cn/apache/hive/hive-3.1.2/apache-hive-3.1.2-bin.tar.gz # 解压 tar -zxvf apache-hive-3.1.2-bin.tar.gz # 重命名，方便后续配置（纯个人习惯，可跳过） mv apache-hive-3.1.2-bin hive-3.1.2

解压后验证一下目录结构：

ls /opt/hive-3.1.2

你会看到 bin、conf、lib、scripts 等目录。其中 bin 目录存放 Hive 的可执行脚本，conf 目录存放配置文件，lib 目录存放依赖 jar 包。

接下来配置环境变量。编辑~/.bashrc（或其他你常用的 shell 配置文件）：

vim ~/.bashrc

在文件末尾追加：

export HIVE_HOME=/opt/hive-3.1.2 export PATH=$PATH:$HIVE_HOME/bin

执行source ~/.bashrc使配置生效，然后验证：

hive --version

能输出版本信息就说明环境变量没问题。

4.2 创建 hive-site.xml 并填写核心配置

Hive 安装包默认没有hive-site.xml文件，只有hive-default.xml.template模板。我们的做法是把模板复制一份，基于它来修改。但这里有个很坑的地方：默认模板里的配置项非常多，直接拿去用会有很多 item 为空的配置项，加起来有三四百行，看着就头大。

我的做法是直接新建一个干净的hive-site.xml，只写必要的核心配置项，这样排错时一眼能看到底，不容易被无关配置干扰。等以后需要调优时再往里面加配置项。

cd /opt/hive-3.1.2/conf touch hive-site.xml vim hive-site.xml

填入以下内容：

<?xml version="1.0" encoding="UTF-8"?> <configuration> <property> <name>javax.jdo.option.ConnectionURL</name> <value>jdbc:mysql://localhost:3306/hive_metastore?createDatabaseIfNotExist=true&amp;useSSL=false&amp;serverTimezone=Asia/Shanghai</value> <description>连接 MySQL 的 JDBC 地址</description> </property> <property> <name>javax.jdo.option.ConnectionDriverName</name> <value>com.mysql.cj.jdbc.Driver</value> <description>MySQL 8.0 驱动类名</description> </property> <property> <name>javax.jdo.option.ConnectionUserName</name> <value>hive</value> </property> <property> <name>javax.jdo.option.ConnectionPassword</name> <value>Hive@123456</value> </property> <property> <name>hive.metastore.warehouse.dir</name> <value>/user/hive/warehouse</value> <description>数据仓库目录，在 HDFS 上</description> </property> <property> <name>hive.metastore.schema.verification</name> <value>false</value> </property> <property> <name>datanucleus.schema.autoCreateAll</name> <value>true</value> </property> </configuration>

关于配置项，有几点要解释一下：

javax.jdo.option.ConnectionURL中的serverTimezone=Asia/Shanghai必须加。MySQL 8.0 和 JDBC 驱动对时区敏感，不加的话连接时可能报The server time zone value 'CST' is unrecognized错误。如果你在国内，服务器时区就是北京时间，填Asia/Shanghai没问题。

hive.metastore.schema.verification和datanucleus.schema.autoCreateAll这两个配置项是配套使用的。前者设为 false 表示跳过 JDO schema 版本校验，后者设为 true 表示让 Hive 自动在 MySQL 中创建元数据表。初始化完成后，建议把autoCreateAll改为 false 或直接删掉，避免每次启动都检查表结构，拖慢启动速度。

4.3 处理 Guava 版本冲突

这是 Hive 安装中踩坑率最高的一步，必须单独拿出来讲。

Hadoop 3.x 自带的 Guava 版本通常是 27.0，而 Hive 3.1.2 自带的是 19.0。两个版本不一致会导致 Hive 启动时报：

java.lang.NoSuchMethodError: com.google.common.base.Preconditions.checkArgument

解决方法很简单：保留高版本的 Guava，删掉低版本的。具体操作：

# 查看 Hadoop 的 Guava 版本 ls /opt/hadoop-3.1.3/share/hadoop/common/lib/ | grep guava # 查看 Hive 的 Guava 版本 ls /opt/hive-3.1.2/lib/ | grep guava

删掉 Hive lib 目录下版本较低的那个，然后拷贝 Hadoop 高版本进来：

# 示例：Hadoop 是 guava-27.0-jre.jar，Hive 是 guava-19.0.jar rm /opt/hive-3.1.2/lib/guava-19.0.jar cp /opt/hadoop-3.1.3/share/hadoop/common/lib/guava-27.0-jre.jar /opt/hive-3.1.2/lib/

这里要特别提醒：删除之前想清楚，别把 Hive lib 里唯一一个 guava 给删没了。操作之前先确认 Hadoop 那边有高版本可以拷贝过来。

4.4 初始化元数据库 schema

配置文件写好了，驱动包也放到位了，现在执行初始化。这一步会在 MySQL 的hive_metastore数据库里创建大量元数据表（version、tbls、cols 等）。

/opt/hive-3.1.2/bin/schematool -dbType mysql -initSchema

执行过程会刷一堆日志，看到schemaTool completed字样就说明成功了。这时候去 MySQL 里看一眼：

USE hive_metastore; SHOW TABLES;

能看到几十张以BUCKETING_COLS、CDS、COLUMNS_V2等命名的表，说明 schema 初始化成功。

如果初始化报错，最常遇到的问题是连接 MySQL 失败。排查步骤：先确认 MySQL 服务在跑（systemctl status mysql），再确认 JDBC 驱动是否真的放在了 Hive 的 lib 目录下，然后检查 ConnectionURL 里填的用户名密码是否正确。还有一点容易被忽略：如果 MySQL 8.0 的认证插件是 caching_sha2_password，而你的连接池特别老，可能要在ConnectionURL里追加allowPublicKeyRetrieval=true参数。

4.5 启动 Hive 并验证功能

元数据初始化完成后，理论上就可以启动 Hive 了。先保证 Hadoop 集群在运行：

start-dfs.sh start-yarn.sh

然后直接启动 Hive CLI：

hive

进入hive>交互界面后，执行以下语句验证：

CREATE DATABASE test_db; USE test_db; CREATE TABLE test_table (id INT, name STRING); INSERT INTO test_table VALUES (1, 'hive'); SELECT * FROM test_table;

执行INSERT INTO时你可能会看到一堆 MapReduce 日志，这说明 Hive 确实在把 SQL 翻译成了分布式任务。如果一切正常，最后一条SELECT会返回一行数据1 hive。

这里额外多说一句：Hive 3.x 之后推荐用 Beeline 连接 HiveServer2 使用，因为 Hive CLI 在新版本里已经标记为 deprecated。但初学阶段先用hive命令体验整个过程最直观，后面再切到 Beeline 也不迟。

启动 HiveServer2 的命令：

nohup /opt/hive-3.1.2/bin/hive --service metastore & nohup /opt/hive-3.1.2/bin/hive --service hiveserver2 &

然后用 Beeline 连接：

/opt/hive-3.1.2/bin/beeline -u jdbc:hive2://localhost:10000 -n hive_user

如果你的 Ubuntu 配置里没有 hive_user 这个系统账号，可以随便填一个存在的用户名，默认 HiveServer2 不做严格认证。

5. 常见报错与排查技巧

5.1 连接类问题：MySQL 连不上、时区报错、权限拒绝

这一类是装 Hive 时遇到频率最高的问题，我直接整理成速查表：

最后那个 Public Key Retrieval 问题，是我自己安装时踩到过最莫名其妙的一个坑。因为我的 MySQL 8.0 默认用 caching_sha2_password 认证，而 JDBC 驱动出于安全策略拒绝无加密地获取公钥，导致连接失败。当时以为是密码错，排查了很久才发现要加这个参数。

5.2 Guava 版本冲突、JDO 初始化失败等典型错误

除了连接问题，初始化阶段和启动阶段还有几个高频报错：

Guava NoSuchMethodError：这个我在 4.3 已经讲过，属于 Hadoop 与 Hive 依赖版本冲突，解决方式就是统一版本。这个报错的诡异之处在于：有时候刚开始是好的，跑了几个小时后突然报错，也是 Guava 版本问题导致的。所以一次配好后，不要轻易升级或降级任何组件。

metaStore schema 初始化失败：报错信息里通常会包含 exception 详情，可能是 MySQL 权限不足，也可能是javax.jdo.option.ConnectionURL里&符号没有转义。在 XML 配置里&必须写成&，很多人在这里看漏了。

Permission denied: user=xxx, access=EXECUTE：这个不是 Hive 本身的问题，是 HDFS 权限不够。Hive 默认以当前 Linux 用户的身份访问 HDFS，而这个用户在 HDFS 上没有user/hive/warehouse目录的读写权限。解决方式：

hdfs dfs -mkdir -p /user/hive/warehouse hdfs dfs -chmod -R 750 /user/hive/warehouse sudo -u hdfs hdfs dfs -chown hive /user/hive/warehouse

注意把命令里的hive换成你的实际用户名。

5.3 WSL 环境下装 Hive 的特殊注意事项

这次热词里有大量 WSL 相关的搜索，说明很多读者其实是在 Windows 的 WSL 里跑 Ubuntu。如果你是在 WSL 下安装，有几个额外的坑要提醒：

WSL 默认不直接支持 systemd，所以systemctl status mysql这类命令可能不能直接生效。解决方式是使用service mysql start来启动 MySQL，效果一样。

WSL 的文件系统 I/O 性能比原生 Linux 慢，启动 Hadoop 和 Hive 时可能需要多等一会儿。初始化 schema 时如果超时，可以重新执行一次，通常第二次就能成功。

还有一个比较大的坑：WSL 的 IP 会随着每次重启变化。如果你在 Windows 宿主机上用 Navicat 之类工具连接 WSL 里的 MySQL，IP 变了就连不上。建议用localhost而不是具体 IP 连接，或者开启 WSL 的 localhost 转发特性。实际上 WSL2 默认就支持 localhost 转发，Windows 宿主机上直接连 localhost 3306 就能访问 WSL 里的 MySQL。

6. 装完之后怎么验证环境没问题

Hive 装好后，不只是能建表就万事大吉。我建议按下面的顺序做一轮完整的冒烟测试，确保环境真的可用：

测试一：Hive 命令行基本操作

-- 创建一个业务表 CREATE TABLE employee ( id INT, name STRING, salary DOUBLE ) ROW FORMAT DELIMITED FIELDS TERMINATED BY ' '; -- 加载本地数据 LOAD DATA LOCAL INPATH '/tmp/employee.txt' INTO TABLE employee; -- 查询验证 SELECT COUNT(*) FROM employee;

这一步验证的是 Hive 到 HDFS 的读写链路。如果 LOAD 报错，检查/tmp/employee.txt是否存在、格式是否符合FIELDS TERMINATED BY指定的分隔符。

测试二：HiveServer2 连接

beeline -u jdbc:hive2://localhost:10000/default -n your_name

执行SHOW DATABASES;，如果返回default和其他你建的库，说明 HiveServer2 正常。这里容易遇到端口不通的问题，可以用ss -tlnp | grep 10000确认服务是否在监听。

测试三：常用 Hive SQL 语法练习

装完之后，顺手把热词里提到的两个常用功能试一遍，一个是修改表名，一个是行转列和列转行。因为这两个操作是日常最常用的，刚装好环境正好用它们验证：

-- 修改表名 ALTER TABLE employee RENAME TO emp; -- 行转列（collect_list + concat） SELECT dept, CONCAT_WS(',', COLLECT_LIST(name)) AS emp_names FROM emp GROUP BY dept; -- 列转行（lateral view + explode） SELECT dept, single_name FROM emp LATERAL VIEW EXPLODE(SPLIT(emp_names, ',')) t AS single_name;

跑通这三个示例，说明你的 Hive 安装基本没有大问题了。

测试四：YARN 资源验证

在 Hive 执行INSERT或SELECT COUNT(*)时，去 YARN 的 Web UI（默认 8088 端口）看是否有 Application 在运行。如果能看到作业状态从 RUNNING 变成 SUCCEEDED，说明整个 Hadoop + Hive 链路是通的。

7. 一些经验之谈：目录规划、快照备份和后置运维

最后这部分，聊聊那些“教程之外”的东西。这些经验是我踩了好几次坑之后总结出来的，虽然不直接影响安装成败，但能让你后续用得更顺。

关于目录规划：不要把所有东西都丢在/opt一个目录下，更不要图方便直接把 Hadoop 和 Hive 解压到 home 目录。我建议统一放在/opt/module/下面，比如/opt/module/hadoop-3.1.3、/opt/module/hive-3.1.2。再在/opt/module下建一个data目录存放下载的安装包和驱动，这样后续清理起来非常方便。

关于快照备份：如果你用的是 VMware 虚拟机或云主机，在 MySQL 安装完成、Hive 初始化成功这两个节点各打一个快照。为什么？因为后续配置调优可能把环境搞坏，有快照可以秒回滚，不用从零开始装。我在刚学 Hive 的时期，最多一天恢复了三次快照。避免重复工作，这是最低成本的保险。

关于 Hive 的日常运维：Hive 说到底是跑在 Hadoop 之上的，所以日常维护的重点不是 Hive 本身，而是底层的 HDFS 空间和 YARN 资源。你要经常留意 HDFS 使用率：

hdfs dfsadmin -report

如果 HDFS 空间不足，表的数据写入就会异常报错。另外 Hive 的元数据备份其实就是备份 MySQL 里的hive_metastore库，建议写个 crontab 定时任务，每天凌晨用 mysqldump 备份一次：

mysqldump -u hive -p'Hive@123456' hive_metastore > /backup/hive_metastore_$(date +%Y%m%d).sql

数据量小的时候，元数据备份恢复是一件特别省心的事情。万一误删了表，找到对应日期的备份文件，把库恢复回去就能找回所有元数据。

最后再分享一个小技巧：Hive 启动时日志输出的地方其实藏得很深。当你启动失败但又没看到具体报错时，先去/tmp/hive/目录下看日志。Hive 会把运行日志写到/tmp/当前用户名/hive.log里，这才是排查问题的第一手材料。很多新手卡住的时候，看半天命令行日志也没找到关键错误，其实真正的 exception 都沉在 hive.log 里。

装完这套环境，你等于打通了大数据离线计算的第一道关卡。后面不管是玩 Spark SQL、Hive 调优还是数据仓库建模，都是在今天装好的这套基础上延展。耐心把每一步做扎实，这个环境至少够你折腾大半年。