一、环境准备与核心组件说明
在开始安装前,先明确 Java Web 开发的核心依赖:
- JDK(Java Development Kit):Java 开发工具包,包含编译器(javac)、运行时环境(JRE),是编写和运行 Java 代码的基础(推荐 JDK 8 或 JDK 11,兼容性最佳)。
- Tomcat:轻量级的 Java Web 服务器,用于部署和运行 Servlet、JSP 等 Web 应用(推荐 Tomcat 8.5/9.0 版本)。
- 操作系统:本文以 Windows 10/11 为例,Linux/macOS 步骤会补充说明。
二、JDK 安装与环境变量配置
2.1 JDK 下载
- 访问 Oracle 官网(https://www.oracle.com/java/technologies/downloads/)或 OpenJDK 镜像(https://jdk.java.net/),下载对应系统的 JDK 安装包(如 jdk-8u381-windows-x64.exe)。
- 注意:Oracle JDK 需登录账号,OpenJDK 可直接下载,功能无差异,新手推荐 OpenJDK。
2.2 JDK 安装
- 双击安装包,按照向导完成安装,建议安装路径不要包含中文、空格(例如:D:\develop\jdk1.8.0_381)。
- 安装过程中无需修改默认选项,记住安装路径(后续配置环境变量需要)。
2.3 环境变量配置(核心步骤)
环境变量的作用是让操作系统全局识别 Java 命令(如 javac、java),Windows 系统配置步骤如下:
步骤 1:打开环境变量配置界面
- 右键「此电脑」→「属性」→「高级系统设置」→「高级」→「环境变量」。
- 在「系统变量」区域进行配置(区别于「用户变量」,系统变量对所有用户生效)。
步骤 2:配置核心环境变量
步骤 3:验证安装是否成功
- 按下Win+R,输入cmd打开命令提示符。
- 执行以下命令,若输出版本信息则说明配置成功:
示例输出:
2.4 Linux/macOS 环境变量配置(补充)
- 编辑环境变量配置文件:
bash
运行
# Linux(CentOS/Ubuntu)
vim /etc/profile
# macOS
vim ~/.bash_profile(或~/.zshrc)
- 添加以下内容:
bash
运行
# 配置JAVA_HOME(替换为实际路径)
export JAVA_HOME=/usr/local/jdk1.8.0_381
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export PATH=$JAVA_HOME/bin:$PATH
- 生效配置:
bash
运行
# Linux
source /etc/profile
# macOS
source ~/.bash_profile
三、Tomcat 安装与启动
3.1 Tomcat 下载
- 访问 Tomcat 官网(https://tomcat.apache.org/),下载对应版本的压缩包(如 apache-tomcat-9.0.80-windows-x64.zip)。
- 解压到无中文、无空格的目录(例如:D:\develop\apache-tomcat-9.0.80)。
3.2 Tomcat 目录结构说明
表格
目录 | 作用 |
bin | 启动 / 关闭脚本(startup.bat/sh、shutdown.bat/sh) |
conf | 配置文件(server.xml:端口配置;web.xml:全局 Web 配置) |
webapps | Web 应用部署目录(将 war 包 / 项目文件夹放入此目录即可部署) |
logs | 运行日志(catalina.out:核心日志) |
temp | 临时文件目录 |
webapps | 项目部署目录 |
work | 编译后的 JSP 文件存放目录 |
3.3 启动 Tomcat
Windows 系统:
- 进入Tomcat/bin目录,双击startup.bat启动服务器(会弹出命令行窗口,不要关闭)。
- 打开浏览器,访问http://localhost:8080,若出现 Tomcat 默认页面则启动成功。
Linux/macOS 系统:
- 赋予脚本执行权限:
bash
运行
chmod +x /usr/local/apache-tomcat-9.0.80/bin/*.sh
- 启动 Tomcat:
bash
运行
# 启动
/usr/local/apache-tomcat-9.0.80/bin/startup.sh
# 关闭
/usr/local/apache-tomcat-9.0.80/bin/shutdown.sh
3.4 常见问题解决
- 端口被占用:Tomcat 默认端口 8080,若被占用,修改conf/server.xml中的端口:
xml
<Connector port="8081" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
- 启动闪退:大概率是 JAVA_HOME 配置错误,检查环境变量是否指向 JDK 根目录(非 jre 目录)。
- 访问 404:确认 Tomcat 已启动,且访问地址的端口与配置一致。
四、验证 Java Web 环境是否可用
编写一个简单的 Servlet 程序,验证环境是否正常:
- 在Tomcat/webapps目录下新建文件夹demo,结构如下:
plaintext
demo/
└── WEB-INF/
├── classes/
│ └── DemoServlet.class
└── web.xml
- 编写 DemoServlet.java(编译后放入 classes 目录):
java
运行
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.IOException;
import java.io.PrintWriter;
public class DemoServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
PrintWriter out = response.getWriter();
out.println("<h1>Java Web环境搭建成功!</h1>");
out.println("JDK版本:" + System.getProperty("java.version"));
out.println("<br>Tomcat版本:" + getServletContext().getServerInfo());
}
}
- 配置 web.xml:
xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
<servlet>
<servlet-name>DemoServlet</servlet-name>
<servlet-class>DemoServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>DemoServlet</servlet-name>
<url-pattern>/demo</url-pattern>
</servlet-mapping>
</web-app>
- 访问http://localhost:8080/demo/demo,若看到页面输出环境信息,则说明整个 Java Web 环境搭建完成。
总结
- 环境变量核心:JAVA_HOME必须指向 JDK 根目录,Path需添加JAVA_HOME/bin,这是保证 java/javac 命令全局可用的关键。
- Tomcat部署要点:安装路径避免中文 / 空格,端口冲突时修改server.xml,Web 应用需放入webapps目录并配置web.xml。
- 验证标准:通过java -version验证 JDK,通过localhost:8080验证 Tomcat,通过简单 Servlet 验证 Web 环境完整性。
搭建完成后,你就可以基于此环境开发 Servlet、JSP、SSM/ Spring Boot 等 Java Web 应用了。后续可结合 IDEA/Eclipse 等 IDE 进一步提升开发效率。