大数据与流处理 / 系统课时

准备 Java 与 Maven

准备 Java 与 Maven

本课完成 Flink Java 开发的基础工具准备:统一使用 JDK 17,安装 Maven,并确认终端中的 java、javac 与 mvn 指向同一套 JDK。完成后,你将得到一个可继续创建 Flink 2.3 项目的稳定构建环境。

学习目标

  • 安装 JDK 17 与 Maven,并理解二者在 Flink 项目中的职责
  • 正确设置 JAVA_HOME 与 PATH,避免终端和 IDE 使用不同 Java
  • 通过版本检查和 Maven 插件调用验证环境可用

统一开发版本

Flink 作业由 Java 编译并运行,Maven负责下载依赖、编译、测试和打包。本课程固定使用 JDK 17;它是长期支持版本,也能减少不同系统之间的行为差异。Maven使用系统中的 Java,因此只安装 JDK 还不够,还要检查 Maven实际识别到的 Java Home。

Windows 用户建议在 WSL2 的 Ubuntu 环境中完成本课程,后续 Flink 的启动脚本可以直接复用 Linux 命令。macOS 和原生 Linux 也可以按相同思路配置。

安装 JDK 与 Maven

在 Ubuntu、Debian 或 WSL2 中执行下面的主安装命令:

bash
sudo apt-get update
sudo apt-get install -y openjdk-17-jdk maven

预期结果:

text
命令退出码为 0,系统中已存在 java、javac 和 mvn 命令。

macOS 已安装 Homebrew 时,可以改用以下命令:

bash
brew install openjdk@17 maven

预期结果:

text
openjdk@17 和 maven 安装完成;Homebrew 输出的实际安装路径可能不同。

Windows 原生环境可以安装任一可信的 JDK 17 发行版和 Maven 3.x 压缩包,然后把 JDK 目录设置为 JAVA_HOME,并将 %JAVA_HOME%\bin 与 Maven 的 bin 目录加入系统 Path。修改环境变量后应重新打开终端。

配置 JAVA_HOME

Ubuntu、Debian 或 WSL2 可以根据 javac 的真实位置生成 JAVA_HOME,并写入当前用户的 Bash 配置:

bash
JAVA_BIN=$(readlink -f "$(command -v javac)")
JAVA_HOME=$(dirname "$(dirname "$JAVA_BIN")")
echo "export JAVA_HOME=$JAVA_HOME" >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

预期结果:

text
命令无错误输出;重新打开终端后,JAVA_HOME 仍指向 JDK 17 安装目录。

macOS 可通过 /usr/libexec/java_home -v 17 查询 JDK 17 根目录,再把对应路径写入 ~/.zshrc 中的 JAVA_HOME。预期查询结果是一条 JDK 17 安装路径。不要把 JAVA_HOME 指向只包含运行环境而缺少 javac 的目录。

验证工具链

依次检查运行时、编译器和构建工具。重点观察 Maven 输出中的 Java version 与 Java home,而不只是 Maven 自身版本。

bash
java -version
javac -version
mvn -version
printf 'JAVA_HOME=%s\n' "$JAVA_HOME"

预期输出:

text
openjdk version "17.<PATCH>" <OTHER>
javac 17.<PATCH>
Apache Maven 3.<MINOR>.<PATCH>
Java version: 17.<PATCH>
Java home: <PATH>
JAVA_HOME=<PATH>

<PATCH>、<MINOR>、<OTHER> 与 <PATH> 会随发行版和安装位置变化。只要主版本为 17,且 Maven显示的 Java home 与 JAVA_HOME 指向同一 JDK,即通过版本检查。

再让 Maven执行一个只读取 Java 属性的插件目标,用于验证 Maven仓库访问与插件运行能力:

bash
mvn help:evaluate -Dexpression=java.specification.version -q -DforceStdout

预期输出:

text
17

首次执行需要联网下载 Maven插件,耗时会比后续执行长。若出现仓库连接错误,应先检查代理、DNS 或企业镜像配置,而不是反复重装 JDK。

典型问题处理

出现 java: command not found 或 mvn: command not found,通常是安装未完成或 PATH 尚未刷新。重新打开终端后再检查,不要只依赖已经打开的旧窗口。

若 java -version 是 17,但 mvn -version 显示其他 Java,说明 Maven继承了错误的 JAVA_HOME。修正环境变量后重新打开终端,直到两处主版本一致。

若 JAVA_HOME 指向 .../bin/java,路径层级配置错误。该变量必须指向 JDK 根目录,根目录下应直接包含 bin、lib 等目录。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备 Java 与 Maven

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通