大数据与流处理 / 系统课时
准备 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 中执行下面的主安装命令:
sudo apt-get update
sudo apt-get install -y openjdk-17-jdk maven预期结果:
命令退出码为 0,系统中已存在 java、javac 和 mvn 命令。macOS 已安装 Homebrew 时,可以改用以下命令:
brew install openjdk@17 maven预期结果:
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 配置:
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预期结果:
命令无错误输出;重新打开终端后,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 自身版本。
java -version
javac -version
mvn -version
printf 'JAVA_HOME=%s\n' "$JAVA_HOME"预期输出:
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仓库访问与插件运行能力:
mvn help:evaluate -Dexpression=java.specification.version -q -DforceStdout预期输出:
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 等目录。