javaee 并不是单独一个独立安装包 它是一套 Java 企业级开发规范 现在旧版 JavaEE 已经改名为 Jakarta EE 很多新手容易误以为 javaee 像普通软件一样双击安装 实际开发环境搭建的核心逻辑是先安装 JDK 再安装 IDE 开发工具 再导入 JavaEE 相关依赖或者应用服务器 比如 Tomcat WildFly 完成整套企业级开发环境 旧版 JavaEE 包含 Servlet JSP EJB JTA 等规范组件 这些组件不需要单独安装 一般通过 Maven 或者 Gradle 引入对应的 jar 包 应用服务器本身实现了这套规范 所以搭建 javaee 开发环境本质就是 JDK 加 IDE 加应用服务器加项目依赖的组合配置 本教程以 Windows 系统为主 兼顾原理说明 适合零基础学习者 下面按照准备工作 分步安装 环境变量配置 服务器集成 项目验证的顺序展开。
前期准备清单
| 项目 | 说明 | 推荐版本 |
|---|---|---|
| JDK | Java 开发核心运行编译环境 | JDK8 或者 JDK11 企业项目最常用 |
| IDE | 代码编写开发工具 | IntelliJ IDEA 或者 Eclipse |
| 应用服务器 | 实现 JavaEE 规范的容器 | Tomcat9 兼容 JavaEE |
| 构建工具 | 管理依赖包 | Maven |
| 操作系统 | 本教程默认 Windows | win10 win11 均可 |
准备要点
第一 下载资源优先选择官方站点 不要从第三方网盘下载修改版安装包 避免捆绑软件
第二 安装路径尽量不要带中文 空格 特殊符号 推荐路径例如 D 盘 java 目录 中文路径非常容易引发后续编译报错
第三 提前确认电脑 CPU 架构 区分 x64 版本 下载对应 JDK 安装包
JDK 安装与环境变量配置
第一步 运行 JDK 安装程序 选择自定义安装路径 等待安装完成
第二步 打开系统高级设置 找到环境变量
第三步 新建系统变量 JAVA_HOME 变量值填写 JDK 安装根目录
第四步 修改 Path 变量 新增两条内容 % JAVA_HOME%\bin 和 % JAVA_HOME%\jre\bin
第五步 新建系统变量 CLASSPATH 变量值填写 .% JAVA_HOME%\lib\dt.jar % JAVA_HOME%\lib\tools.jar
第六步 打开 cmd 命令窗口 输入 java -version 再输入 javac -version 如果可以正常输出版本号 代表 JDK 配置成功
注意事项
JDK11 之后已经取消独立 jre 目录 CLASSPATH 变量不再强制配置 老教程里面的 CLASSPATH 配置是 JDK8 时代的做法 高版本可以省略
Tomcat 应用服务器安装配置
第一步 下载 Tomcat 压缩包 解压到纯英文路径 不需要传统下一步式安装
第二步 确认 JDK 已经配置成功 Tomcat 启动依赖 JDK
第三步 进入 Tomcat 目录 bin 文件夹 双击 startup.bat 启动服务
第四步 打开浏览器访问 localhost8080 如果出现 Tomcat 默认首页 代表服务器启动成功
第五步 如果启动闪退 优先检查 JAVA_HOME 变量是否配置正确 端口 8080 被占用也会启动失败 可以修改 conf 目录下 server.xml 里面的端口号
IDE 集成 Tomcat 与 JavaEE 项目
IntelliJ IDEA 操作步骤
第一步 打开 IDEA 新建项目 选择 Java Enterprise 也就是企业级项目 对应 javaee 开发类型
第二步 项目设置里面添加 Tomcat 服务器配置 选择本地 Tomcat 安装目录
第三步 在 pom.xml 文件添加 JavaEE 相关依赖 也就是 Servlet JSP 规范依赖 旧版本依赖名称为 javaee-api
第四步 编写第一个 Servlet 测试类 配置 web.xml 或者使用注解方式映射访问路径
第五步 启动服务器 浏览器访问 Servlet 地址 可以正常返回页面内容 代表整套 javaee 环境搭建成功
Eclipse 操作补充
第一步 打开 Eclipse 新建 Dynamic Web Project 动态 Web 项目 这个项目类型就是 javaee 项目
第二步 在项目属性里面配置 Target Runtime 绑定本地 Tomcat
第三步 项目右键 Run on Server 直接启动部署项目
Maven 依赖配置要点
javaee-api 依赖是核心 作用是提供 Servlet JSP 等规范类 注意这个依赖 scope 要设置为 provided 意思是编译期使用 运行的时候由 Tomcat 容器提供 不需要打包进 war 包 如果不设置 provided 容易出现类冲突报错
旧版 javaee-api 在新版规范迁移之后 官方推荐替换成 jakartaee 相关依赖 新项目尽量选择 Jakarta EE 老项目继续沿用旧 javaee-api 即可
常见故障排查清单
第一 cmd 执行 java -version 提示不是内部命令 检查 JAVA_HOME 和 Path 配置 是否拼写错误
第二 Tomcat 启动闪退 检查 JDK 版本是否和 Tomcat 版本兼容 Tomcat9 支持 JDK8 及以上
第三 IDE 里面找不到 Java Enterprise 项目选项 检查 IDE 版本 是否缺少 JavaEE 相关插件
第四 项目启动报类找不到 检查 Maven 依赖是否加载成功 pom 文件是否存在语法错误
第五 访问页面 404 检查 Servlet 映射路径 是否和浏览器访问地址一致 项目是否成功部署到 Tomcat
整套 javaee 环境搭建完成之后 就可以开发 Servlet JSP Filter Listener 这类企业级 Web 应用 要记住核心概念 javaee 是规范 不是软件 应用服务器负责实现规范 JDK 负责编译运行代码 IDE 负责开发编辑 Maven 负责依赖管理 三者配合才是完整开发环境 新项目可以优先了解 Jakarta EE 它是 JavaEE 更名之后的后续版本 生态持续更新。
【常见问题】
问题 1 javaee 安装教程里面 javaee 是不是单独软件需要单独安装
回答 1 javaee 安装教程核心知识点就是 javaee 本身是开发规范 不是独立软件 不需要单独双击安装 只需要安装 JDK Tomcat IDE 再引入对应依赖完成环境搭建
问题 2 javaee 安装教程 JDK8 和 JDK11 哪个更适合做 javaee 开发
回答 2 javaee 安装教程推荐优先 JDK8 大量传统 javaee 老项目都基于 JDK8 开发 兼容性最好 如果学习新项目 也可以选择 JDK11
问题 3 javaee 安装教程 为什么 Tomcat 启动之后访问 8080 打不开首页
回答 3 javaee 安装教程里这个故障常见原因是 JAVA_HOME 没有配置 或者 8080 端口被其他程序占用 修改端口或者修复环境变量就可以解决
问题 4 javaee 安装教程 旧版 javaee 和 Jakarta EE 是什么关系
回答 4 javaee 安装教程需要了解 旧 JavaEE 规范移交基金会之后正式改名为 Jakarta EE 属于同一套企业级规范的延续 包名从 javax 改成 jakarta 新项目推荐使用 Jakarta EE
【免责申明】
本 javaee 安装教程基于通用 Windows 环境公开技术资料整理 不同 JDK Tomcat IDE 版本操作界面会存在差异 教程仅作为学习参考 生产环境部署请结合公司规范 本内容不保证所有系统环境都可以一次成功 出现特殊报错建议查阅对应软件官方文档 本内容不构成商业项目部署的技术担保