首页 · 站点总览
本手册专为希望系统掌握 Java Web 开发的开发者打造,内容覆盖从基础语法、Servlet/JSP、主流框架(Spring、Spring Boot、MyBatis)、数据库集成、性能调优、高并发设计、安全防护到云原生部署等全链路技术体系。所有内容均基于真实企业级项目实践,拒绝空洞理论,强调可落地性与工程化思维。
当前 Java Web 技术栈已深度融入金融、电商、政务、教育、医疗等关键行业信息系统建设,其稳定、高效、生态成熟等优势持续吸引新一代开发者加入。无论您是零基础入门者,还是有经验的工程师,本手册均提供分层学习路径与深度技术拓展。
为什么选择本手册?
- • 结构清晰:按技术演进逻辑组织内容,从 Servlet 到 Spring Cloud,循序渐进
- • 案例驱动:每个核心模块配备完整可运行示例(含 Maven/Gradle 工程结构)
- • 与时俱进:持续更新至 Java 17+、Spring Boot 3.x、Jakarta EE 10 标准
- • 避坑指南:标注常见误区与生产环境陷阱,提升工程鲁棒性
- • 生态整合:深入讲解与 MySQL、Redis、Nginx、Docker、K8s 的协同机制
本页面所有导航均为锚点跳转,无跳转延迟,确保多终端体验流畅。全文内容严格遵循 SEO 规范,使用语义化标签,提升搜索引擎友好度。全站采用响应式布局,适配手机、平板、桌面设备,确保在 320px 至 2560px 宽度范围内均能完美呈现。
核心模块 · Servlet 与 JSP 深度解析
尽管现代开发多使用 Spring Boot 等框架封装底层细节,但深入理解 Servlet 与 JSP 仍是构建健壮 Java Web 应用的基石。Servlet 作为 Java EE 规范的核心组件,定义了 Web 请求处理的标准接口;JSP 则通过模板机制简化动态页面生成,二者共同构成 Jakarta Servlet 规范的基础。
Servlet 生命周期详解
一个 Servlet 实例的生命周期由容器(如 Tomcat)管理,包含以下阶段:
- • 实例化:容器调用无参构造器创建对象(仅一次)
- • 初始化:执行
init(ServletConfig)方法,用于加载配置、建立连接池等 - • 服务:每次请求调用
service(HttpServletRequest, HttpServletResponse) - • 销毁:容器关闭或重启时调用
destroy(),释放资源
注意:Servlet 默认为单例多线程模式,因此成员变量需谨慎使用,避免线程安全问题。推荐使用局部变量或 ThreadLocal 隔离状态。
JSP 隐式对象与作用域
JSP 页面中可直接使用的 9 个隐式对象(无需声明):
| 对象名 | 类型 | 作用域 | 典型用途 |
|---|---|---|---|
request |
HttpServletRequest | request | 获取表单参数、请求头、转发请求 |
session |
HttpSession | session | 用户登录状态管理、购物车存储 |
application |
ServletContext | application | 全局配置、在线人数统计 |
out |
JspWriter | page | 向客户端输出 HTML 内容 |
pageContext |
PageContext | page | 存取域属性、包含页面、转发 |
作用域优先级:page < session < request < application。合理选择作用域可避免内存泄漏与数据错乱。
请求处理流程图解
客户端 → Nginx(反向代理/负载均衡)
↓
Tomcat(AJP/HTTP 连接器)
↓
Filter(请求过滤:编码、权限校验)
↓
Servlet(调用 service 方法)
↓
Service 层(业务逻辑)
↓
DAO 层(数据库操作)
↓
响应逐层返回 → 客户端
主流框架 · Spring 生态全景
Spring 框架作为 Java Web 开发的事实标准,通过 IoC(控制反转)、AOP(面向切面编程)、事务管理等机制极大提升开发效率与系统解耦度。其模块化设计支持“按需引入”,避免冗余依赖。
Spring Core 核心容器
IoC 容器是 Spring 的基石,通过 XML 或注解配置 Bean 定义,运行时动态注入依赖。典型 Bean 作用域:
- • singleton:单例(默认),容器启动时创建(可配置 lazy-init 延迟)
- • prototype:多例,每次请求创建新实例
- • request/session/application:Web 环境专用作用域
依赖注入方式:构造器注入(推荐,保证不可变性)、Setter 注入(灵活性高)、接口注入(已弃用)。
构造器注入示例
public class UserService {
private final UserRepository repo;
public UserService(UserRepository repo) {
this.repo = repo; // 确保依赖非空
}
}
Spring MVC 请求处理流程
核心组件协同工作:
- • DispatcherServlet:前端控制器,接收所有请求
- • HandlerMapping:匹配 Controller(如 @RequestMapping)
- • Controller:业务入口,处理请求并返回 ModelAndView
- • ViewResolver:解析视图名,渲染模板(如 Thymeleaf)
- • View:生成最终 HTML 响应
现代开发中,RESTful API 常返回 JSON(通过 @ResponseBody 或 @RestController),前端通过 AJAX 渲染,实现前后端分离。
REST API 示例
@RestController
@RequestMapping("/api/users")
public class UserController {
private final UserService service;
public UserController(UserService service) {
this.service = service;
}
@GetMapping("/{id}")
public ResponseEntity getUser(@PathVariable Long id) {
return ResponseEntity.ok(service.findById(id));
}
}
Spring Boot 自动配置原理
通过 @EnableAutoConfiguration 启用自动配置,Spring Boot 扫描 classpath 下的 META-INF/spring.factories 文件,加载符合条件的 AutoConfiguration 类(如 DataSourceAutoConfiguration)。
条件化装配机制(@Conditional 系列注解)确保仅在满足特定条件时生效,例如:
- •
@ConditionalOnClass:类路径存在某类 - •
@ConditionalOnMissingBean:容器中不存在指定 Bean - •
@ConditionalOnProperty:配置文件中存在某属性
自定义 Starter 示例
创建 META-INF/spring.factories:
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.autoconfigure.MyAutoConfiguration
Spring Data JPA 与 MyBatis 对比
| 特性 | Spring Data JPA | MyBatis |
|---|---|---|
| 学习曲线 | 陡峭(需理解 ORM 概念) | 平缓(直接写 SQL) |
| SQL 控制力 | 受限于 JPA 规范 | 完全可控 |
| 动态 SQL | 需用 JPQL/Criteria API | XML + |
| 性能 | 可能产生冗余查询 | 精准控制,性能更优 |
| 适用场景 | CRUD 简单、实体关系清晰 | 复杂报表、多表联查、性能敏感 |
开发实践 · 工程化与工具链
高效开发依赖完善的工程化体系:版本管理(Git)、构建工具(Maven/Gradle)、测试框架(JUnit/TestNG)、代码规范(Checkstyle/PMD)缺一不可。
Maven 与 Gradle 选型指南
Maven:基于 XML 配置,约定大于配置,适合大型团队及传统项目,插件生态成熟(如 Maven Site、Surefire)。
Gradle:基于 Groovy/Kotlin DSL,构建脚本更简洁,增量构建快,支持并行任务,适合微服务与快速迭代项目。
推荐组合:Spring Boot + Gradle(官方默认),传统项目沿用 Maven。
mvn dependency:tree 或 ./gradlew dependencies 分析依赖冲突,通过 exclusions 排除传递依赖。
单元测试最佳实践
遵循 FIRST 原则:Fast(快速)、Independent(独立)、Repeatable(可重复)、Self-Validating(自验证)、Timely(及时)。
- • 使用 @ExtendWith(MockitoExtension.class) 整合 Mockito,隔离外部依赖
- • 避免在测试中调用真实数据库(用内存 H2 或 @DataJpaTest)
- • 测试类命名以
Test结尾,方法以should或given...when...开头 - • 覆盖率目标:核心业务逻辑 ≥80%,工具类 ≥70%
Mockito 示例
@ExtendWith(MockitoExtension.class)
class UserServiceTest {
@Mock
private UserRepository repo;
@InjectMocks
private UserService service;
@Test
void shouldReturnUserWhenIdExists() {
when(repo.findById(1L)).thenReturn(Optional.of(new User()));
User user = service.findById(1L);
assertNotNull(user);
verify(repo).findById(1L);
}
}
RESTful API 设计规范
遵循统一规范提升可维护性:
- • 资源命名:复数名词(/users),避免动词(/getUsers)
- • 方法语义:GET(查)、POST(增)、PUT(全量改)、PATCH(部分改)、DELETE(删)
- • 状态码:200(成功)、201(创建)、400(参数错误)、401(未认证)、403(无权限)、404(不存在)、500(服务器错误)
- • 错误响应:统一格式
{ "code": 400, "message": "Invalid user ID", "timestamp": "2025-04-05T10:30:00Z" }
全局异常处理器示例
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BusinessException.class)
public ResponseEntity handleBusinessException(BusinessException ex) {
return ResponseEntity.badRequest().body(new ErrorResponse(400, ex.getMessage()));
}
}
部署运维 · 生产级发布流程
部署不仅是文件传输,更涉及环境隔离、配置管理、灰度发布与监控告警。现代 Java Web 应用趋向容器化与云原生部署。
传统部署 vs 容器化部署对比
| 维度 | 传统部署 | 容器化部署(Docker) |
|---|---|---|
| 环境一致性 | 易出现“在我机器能跑”问题 | 镜像确保环境绝对一致 |
| 启动速度 | 分钟级(需安装 JDK/DB) | 秒级(镜像预装依赖) |
| 资源隔离 | 进程级,共享 OS 内核 | 容器级,独立文件系统 |
| 扩缩容 | 手动复制文件,易出错 | K8s 声明式扩缩容 |
Docker 部署 Spring Boot 实战
1. 创建 Dockerfile:
FROM openjdk:17-jdk-slim
WORKDIR /app
COPY target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java","-jar","app.jar"]
2. 构建并运行:
docker build -t java-web-app .
docker run -d -p 8080:8080 --name myapp java-web-app
3. 集成 Docker Compose 管理多容器:
version: '3.8'
services:
app:
image: java-web-app
ports:
- "8080:8080"
depends_on:
- db
- redis
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: appdb
redis:
image: redis:7-alpine
CI/CD 自动化流水线
典型 GitLab CI 流程:
- • Commit → 触发 pipeline
- • Build:Maven 构建 JAR,运行单元测试
- • Scan:SonarQube 代码质量检查
- • Build Image:Docker 构建镜像,推送到 Harbor
- • Deploy:K8s 执行 helm upgrade 或 kubectl apply
- • Verify:Prometheus 监控新版本健康状态
测试体系 · 全链路质量保障
测试分层模型(Test Pyramid)强调:单元测试 > 集成测试 > 端到端测试。过度依赖 UI 自动化(如 Selenium)成本高、易碎,应优先夯实底层测试。
单元测试核心要点
• 使用 Spring Boot Test + @SpringBootTest 启动完整上下文(慎用)
• 使用 @WebMvcTest 仅加载 Web 层,配合 MockMvc 测试 Controller
• 使用 @DataJpaTest 仅加载 JPA 配置,测试 Repository
MockMvc 示例
@WebMvcTest(UserController.class)
class UserControllerTest {
@Autowired
private MockMvc mockMvc;
@MockBean
private UserService service;
@Test
void shouldReturnUserList() throws Exception {
when(service.findAll()).thenReturn(List.of(new User()));
mockMvc.perform(get("/api/users"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.length()").value(1));
}
}
集成测试实践
验证模块间协作是否正常,需启动完整 Spring 上下文并连接测试数据库(H2 或 Testcontainers)。
集成测试示例
@SpringBootTest
@AutoConfigureTestDatabase(replace = Replace.NONE)
class UserServiceIntegrationTest {
@Autowired
private UserRepository repo;
@Test
void shouldSaveAndRetrieveUser() {
User user = new User("test@example.com");
repo.save(user);
Optional found = repo.findById(user.getId());
assertTrue(found.isPresent());
}
}
端到端测试建议
• 仅对核心业务流(如登录→下单→支付)进行 E2E 测试
• 使用 Playwright 或 Cypress 替代 Selenium(更快、更稳定)
• 配合 Testcontainers 启动真实依赖(MySQL、Redis)
性能优化 · 从 JVM 到数据库
性能优化需基于数据驱动,避免“拍脑袋”调优。使用 JProfiler、VisualVM、Micrometer + Prometheus 等工具采集指标。
常见性能瓶颈与对策
| 瓶颈点 | 诊断工具 | 优化策略 |
|---|---|---|
| JVM 内存 | VisualVM、jstat | 调整堆大小(-Xms/-Xmx),避免内存泄漏 |
| 数据库查询 | 慢查询日志、EXPLAIN | 加索引、拆分大表、读写分离 |
| 缓存击穿 | Prometheus 监控 | 布隆过滤器、互斥锁、逻辑过期 |
| 线程阻塞 | VisualVM 线程转储 | 线程池隔离、异步处理(@Async) |
Redis 缓存实战技巧
• 缓存策略:Cache-Aside(最常用)、Read-Through、Write-Through
• Key 设计:业务前缀 + ID + 版本号(如 user:123:v2)
• 过期策略:随机过期时间防雪崩(如 ttl + random(0, 300))
缓存双写一致性方案
方案1:先删缓存再更新 DB → 问题:删缓存后、更新前有请求读旧数据
方案2:先更新 DB 再删缓存 → 推荐!短暂不一致可接受,最终一致
方案3:使用 Debezium 监听 DB 变更事件 → 高可靠,但架构复杂
JVM 参数调优参考
针对 8 核 16GB 服务器部署的 Spring Boot 应用:
-Xms8g -Xmx8g \
-XX:+UseG1GC \
-XX:MaxGCPauseMillis=200 \
-XX:G1HeapRegionSize=4m \
-Djava.security.egd=file:/dev/./urandom
• G1 GC 适合大堆内存,减少 STW 时间
• -Djava.security.egd 加速 Tomcat 启动(避免 /dev/random 阻塞)
安全防护 · Web 应用安全基石
OWASP Top 10 指出常见 Web 漏洞,需在 Java Web 开发中主动防御。
核心安全措施清单
- • CSRF 防护:启用 Spring Security CSRF Token,或使用 SameSite Cookie
- • XSS 防护:Thymeleaf 默认转义;若用原生 JSP,手动调用 JSTL
<c:out> - • SQL 注入:使用 PreparedStatement / JPA Criteria API,禁止字符串拼接
- • 认证授权:Spring Security + JWT/OAuth2,角色粒度控制(@PreAuthorize("hasRole('ADMIN')"))
- • 敏感信息:密码使用 BCrypt 加密,配置文件加密(Jasypt)
- • 日志脱敏:避免记录密码、身份证、银行卡号
JWT 安全使用规范
• 仅在 HTTPS 下传输(Set-Cookie: Secure; HttpOnly)
• 设置合理过期时间(access_token: 15~30 分钟;refresh_token: 7~30 天)
• 禁止在 Token 中存储敏感信息(加密后仍不推荐)
• 实现 Token 撤销:维护 Redis 黑名单(refresh_token 失效时)
安全 JWT 配置示例
@Bean
public JwtEncoder jwtEncoder() {
KeyPair keyPair = new KeyPairGenerator("RSA")
.generateKeyPair();
return new NimbusJwtEncoder(
new ImmutableSecret<>(keyPair.getPrivate()));
}
云原生 · 微服务与 Kubernetes
云原生架构(Cloud Native)已成为 Java Web 应用的演进方向,通过容器化、微服务、DevOps 与可观测性提升系统弹性。
Spring Cloud 核心组件
| 组件 | 功能 | 替代方案 |
|---|---|---|
| Eureka | 服务注册与发现 | Nacos、Consul |
| Feign | 声明式 HTTP 客户端 | Spring Cloud Gateway + WebClient |
| Hystrix | 熔断降级 | Resilience4j(轻量、响应式) |
| Config Server | 集中配置管理 | Nacos、Spring Cloud Config + Git |
响应式编程入门(Project Reactor)
Spring WebFlux 基于 Reactor 实现非阻塞 I/O,适合高并发 IO 密集型场景(如网关、微服务通信)。
WebFlux 示例
@RestController
@RequestMapping("/reactive/users")
public class ReactiveUserController {
private final UserRepository repo;
public ReactiveUserController(UserRepository repo) {
this.repo = repo;
}
@GetMapping
public Flux getAll() {
return repo.findAll(); // Flux 表示 0~N 个元素流
}
@GetMapping("/{id}")
public Mono getById(@PathVariable Long id) {
return repo.findById(id); // Mono 表示 0 或 1 个元素
}
}
Kubernetes 部署要点
• Deployment:管理 Pod 副本与滚动更新
• Service:提供稳定 VIP(ClusterIP/NodePort/LoadBalancer)
• ConfigMap/Secret:解耦配置与代码
• Ingress:统一入口路由(替代 Nginx 反向代理)
Deployment 示例
apiVersion: apps/v1
kind: Deployment
metadata:
name: java-app
spec:
replicas: 3
selector:
matchLabels:
app: java-app
template:
metadata:
labels:
app: java-app
spec:
containers:
- name: app
image: registry.example.com/java-app:v1.2.3
ports:
- containerPort: 8080
resources:
requests:
memory: "512Mi"
cpu: "250m"
limits:
memory: "1Gi"
cpu: "500m"
实战案例 · 电商系统设计思路
以典型电商系统为例,展示 Java Web 技术栈的综合应用:
架构分层
• 前端:Vue3 + Vite + Pinia(响应式 SPA)
• 网关:Spring Cloud Gateway(路由、限流、认证)
• 业务层:订单、用户、商品、库存微服务(Spring Boot)
• 数据层:MySQL 主从 + Redis 缓存集群 + Elasticsearch 搜索
高并发秒杀设计
• 库存预热:提前加载 Redis
• 请求排队:RabbitMQ 消息队列削峰
• 分布式锁:Redis SETNX 保证库存扣减原子性
• 异步通知:订单创建后发短信/消息
数据一致性保障
• 分布式事务:Seata AT 模式(订单创建 → 扣库存 → 更新积分)
• 最终一致性:本地消息表 + 定时重试
• 幂等设计:订单号作为唯一键防重复提交
技术选型对比表
| 技术 | 推荐版本 | 选型理由 |
|---|---|---|
| Spring Boot | 3.2.x | 支持 Jakarta EE 10,原生 GraalVM 本地镜像 |
| MySQL | 8.0 LTS | JSON 支持、窗口函数、原子 DDL |
| Redis | 7.2 | Stream 支持消息队列、模块生态(RedisTimeSeries) |
| Spring Security | 6.2 | 无 WebSecurityConfigurerAdapter,声明式配置 |
关于本手册 · 持续更新说明
java web学习手册 由一线 Java 工程师团队维护,内容基于真实项目经验提炼。我们坚持:
- • 技术中立:不推广特定厂商方案,客观对比主流技术
- • 实战导向:所有示例可运行,提供 GitHub 仓库地址
- • 版本跟踪:Java 21+、Spring Boot 3.x、Jakarta EE 10 优先支持
- • 社区共建:欢迎提交 Issue/PR,共同完善知识体系
本手册内容遵循 CC BY-NC-SA 4.0 许可,非商业用途可自由转载,但需署名并保持相同协议。商业用途请提前联系授权。