JSP trong Spring MVC là kiểu di sản dễ nhận ra: mvn spring-boot:run render trang bình thường, nhưng mvn package rồi java -jar app.jar thì mọi request trả 404. Không phải lỗi cấu hình — file JSP và thư mục WEB-INF không nằm trong jar. Bài này giải thích cơ chế JSP để bạn bảo trì hệ thống cũ, rồi chỉ ra lựa chọn cho giao diện server-side năm 2026: Thymeleaf hoặc frontend riêng gọi JSON API. JSP là lựa chọn legacy, không phải khuyến nghị.
Code dưới đây chạy trên Spring Boot 4.1.2, Spring Framework 7.0.10, Java 25 LTS; Tomcat nhúng 11.0.27 với Servlet 6.1.
Mục lục
Cập nhật 2026
- JSP vẫn bị khuyến nghị tránh. Tài liệu Spring Boot nói rõ nên tránh JSP với embedded servlet container. JSP chỉ chạy đúng khi đóng gói WAR; executable jar không hỗ trợ.
- Jakarta EE 11, không còn javax. Package là
jakarta.servlet.jsp(Jakarta Pages 4.0), taglib URI làjakarta.tags.core. Mọi importjavax.servlet.*trong tutorial cũ không compile trên Boot 4.1.2. - Starter đổi tên. Boot 4.1 deprecate
spring-boot-starter-web, dùngspring-boot-starter-webmvc. - Thymeleaf là đường ra. Boot 4.1.2 quản lý Thymeleaf 3.1.5; nó không cần WAR và không phụ thuộc servlet API.
Vòng đời JSP: từ file .jsp đến servlet
JSP không phải HTML có chèn Java. Nó là một servlet viết ngược: container dịch file .jsp thành class Java implement jakarta.servlet.jsp.HttpJspPage, rồi chạy class đó qua vòng đời servlet. Sáu bước, và mỗi bước giải thích một lỗi bạn sẽ gặp.
- Translation. Request đầu tiên đưa
greeting.jspcho Jasper. Jasper sinh một file Java tạm, class có tên dạnggreeting_jsp: HTML tĩnh thành các lệnhout.write(...), EL và tag thành lời gọi API. - Compilation. ECJ compile file Java đó thành
.class. Đây là lý dotomcat-embed-jasperkéo theoorg.eclipse.jdt:ecj. - Loading. Webapp classloader nạp class; mỗi file JSP ứng với một servlet instance.
- Initialization. Container gọi
jspInit(), tương đươnginit()của servlet. - Request handling. Mỗi request gọi
_jspService(request, response). Không códoGethaydoPostriêng. - Destruction. Khi container shutdown hoặc webapp reload,
jspDestroy()chạy.
Translation và compilation chỉ chạy một lần cho mỗi phiên bản file, sau đó class được cache trong thư mục work của Tomcat. Điểm mấu chốt: cả hai bước cần file nguồn .jsp trên filesystem. Trong executable jar, file nằm trong archive và không có thư mục webapp, nên Jasper không có gì để dịch. Đó là gốc của lỗi 404 ở đầu bài.
EL, JSTL và taglib
EL (${...}) đọc attribute, không chạy Java. Nó tìm tên theo thứ tự page, request, session, application scope. Spring MVC đặt mọi attribute của Model vào request scope trước khi forward, nên ${name} chính là giá trị của model.addAttribute("name", ...). Các implicit object hay dùng: pageContext, request, session, param, header.
EL không escape HTML. ${name} in nguyên chuỗi người dùng nhập, kể cả thẻ script. JSTL giải quyết phần này, và từ Jakarta EE 11 URI taglib đã đổi tên:
<%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<%@ taglib uri="jakarta.tags.core" prefix="c" %>
<%@ taglib uri="jakarta.tags.fmt" prefix="fmt" %>
<%@ taglib uri="jakarta.tags.functions" prefix="fn" %>
<c:out value="${user.bio}"/> escape XML mặc định; escapeXml="false" tắt nó và mở đường XSS. Khi EL nằm trong attribute, dùng fn:escapeXml() chứ không dựa vào c:out: title="${fn:escapeXml(user.bio)}". Phần logic dùng <c:if>, <c:choose>, <c:forEach>; định dạng dùng <fmt:formatNumber> cho tiền VND và <fmt:formatDate> cho ngày; <c:url> thêm context path vào link.
Nhưng escape của <c:out> chỉ an toàn cho nội dung thẻ. Trong href, style hoặc một biến JavaScript, cùng một chuỗi cần cách encode khác. Template engine hiện đại xử lý escaping theo ngữ cảnh; JSP thì không, và đây là lý do kỹ thuật để không xây UI mới bằng JSP.
Cấu hình JSP trong Spring MVC trên Boot 4.1
Năm dependency, hai property, một thư mục. JSP không có starter riêng vì nó không phải lựa chọn mặc định của Boot.
<!-- File: pom.xml -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>4.1.2</version>
</parent>
<packaging>war</packaging>
<properties>
<java.version>25</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webmvc</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>jakarta.servlet.jsp.jstl</groupId>
<artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
</dependency>
<dependency>
<groupId>org.glassfish.web</groupId>
<artifactId>jakarta.servlet.jsp.jstl</artifactId>
</dependency>
</dependencies>
Ba điểm trong pom. <packaging>war</packaging> là bắt buộc cho JSP. tomcat-embed-jasper là engine JSP, scope provided để container cung cấp lúc chạy; jar này đã chứa API jakarta.servlet.jsp, nên không cần khai báo thêm jakarta.servlet.jsp-api. Ngược lại, nó không chứa JSTL, dù nhiều tutorial cũ nói vậy: bạn phải thêm API 3.0.2 và implementation GlassFish 3.0.1, cả hai đều được Boot 4.1.2 quản lý phiên bản.
Hai property là spring.mvc.view.prefix=/WEB-INF/views/ và spring.mvc.view.suffix=.jsp. File đặt tại src/main/webapp/WEB-INF/views/greeting.jsp. Thư mục webapp chỉ có nghĩa với WAR; đặt JSP trong src/main/resources thì Spring không bao giờ tìm thấy.
mvn spring-boot:run vẫn chạy vì plugin đưa cả dependency provided vào classpath và Boot dùng src/main/webapp làm docBase. Khi deploy lên Tomcat ngoài, thêm class ServletInitializer extends SpringBootServletInitializer. Với java -jar app.war, các jar provided nằm trong WEB-INF/lib-provided và vẫn được nạp.
InternalResourceViewResolver và WEB-INF/views
InternalResourceViewResolver biến tên view logic thành đường dẫn: prefix + tên + suffix. Với cấu hình trên, return "greeting" thành forward tới /WEB-INF/views/greeting.jsp. Forward giữ nguyên URL trên browser; return "redirect:/..." bỏ qua resolver và phát 302.
Boot tự tạo resolver từ hai property spring.mvc.view.*. Chỉ định nghĩa bean khi bạn cần JstlView để các thẻ <fmt:message> dùng MessageSource của Spring:
// File: src/main/java/com/example/legacy/web/WebConfig.java
package com.example.legacy.web;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.view.InternalResourceViewResolver;
import org.springframework.web.servlet.view.JstlView;
@Configuration
public class WebConfig {
@Bean
InternalResourceViewResolver jspViewResolver() {
InternalResourceViewResolver resolver = new InternalResourceViewResolver();
resolver.setViewClass(JstlView.class);
resolver.setPrefix("/WEB-INF/views/");
resolver.setSuffix(".jsp");
return resolver;
}
}
Đừng thêm @EnableWebMvc. Annotation này tắt auto-configuration của Boot, kéo theo mất static resource handling, message converter và các property spring.mvc.*. Một class @Configuration implement WebMvcConfigurer là đủ.
WEB-INF không truy cập trực tiếp từ browser theo Servlet spec; chỉ forward nội bộ mới đọc được. Đặt JSP ngoài WEB-INF nghĩa là người dùng gọi thẳng file và bỏ qua cả controller lẫn security.
Một hệ quả ít người để ý: InternalResourceView gọi RequestDispatcher.forward, và forward ghi thẳng vào response. Nếu JSP ném exception giữa lúc render và response đã commit, @ControllerAdvice không còn cơ hội ghi JSON hay trang lỗi chuẩn. Đó là lý do các app JSP thường có trang error.jsp riêng, còn app API không gặp vấn đề này.
Khi migrate dần, bạn có thể giữ JSP cho một số trang và thêm Thymeleaf cho trang mới, miễn là hai bộ template dùng tên view khác nhau để không tranh nhau. Chuyển từng trang nhỏ luôn rẻ hơn một lần thay toàn bộ view.
Ví dụ: cùng một controller, hai template
Controller dưới đây không biết view nào sẽ render nó, nên nó dùng được cho cả JSP và Thymeleaf:
// File: src/main/java/com/example/legacy/web/GreetingController.java
package com.example.legacy.web;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
@Controller
public class GreetingController {
@GetMapping("/greeting")
public String greeting(@RequestParam(required = false) String name, Model model) {
model.addAttribute("name", name);
return "greeting";
}
}
JSP tương ứng. Chú ý <c:out> thay vì ${name} trần:
<%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<%@ taglib uri="jakarta.tags.core" prefix="c" %>
<!DOCTYPE html>
<html lang="vi">
<head><meta charset="UTF-8"><title>Xin chào</title></head>
<body>
<h1>Xin chào <c:out value="${name}"/></h1>
<c:if test="${empty name}">
<p>Bạn chưa nhập tên.</p>
</c:if>
</body>
</html>
Bản Thymeleaf, cùng dữ liệu và cùng tên view:
<!DOCTYPE html>
<html lang="vi" xmlns:th="http://www.thymeleaf.org">
<head><meta charset="UTF-8"><title>Xin chào</title></head>
<body>
<h1>Xin chào <span th:text="${name}">bạn</span></h1>
</body>
</html>
th:text escape HTML mặc định, nên không cần thẻ kiểu c:out. File nằm ở src/main/resources/templates/greeting.html; Thymeleaf resolver dùng prefix classpath:/templates/ và suffix .html, nên return "greeting" vẫn đúng. Mở file trực tiếp bằng browser vẫn thấy HTML tĩnh với chữ “bạn”: đó là natural template, designer sửa được mà không cần chạy app.
| Tiêu chí | JSP | Thymeleaf |
|---|---|---|
| Vị trí template | src/main/webapp/WEB-INF/views |
src/main/resources/templates |
| Đóng gói | WAR | jar hoặc war |
| Escape mặc định | Không; phải dùng c:out |
Có, trong th:text |
Bảo mật: escaping và CSRF
Ba việc, không hơn. Một: không render dữ liệu người dùng bằng ${...} trần. Hai: dùng <c:out> hoặc fn:escapeXml(), và nhớ escaping phải khớp ngữ cảnh. Ba: để CSRF của Spring Security bảo vệ mọi form POST.
Với Spring Security 7.1.2, CSRF bật mặc định. Form viết bằng <form:form> của Spring form taglib (URI http://www.springframework.org/tags/form) tự nhận hidden field _csrf qua CsrfRequestDataValueProcessor. Form HTML thuần phải tự thêm <input type="hidden" name="_csrf" value="${_csrf.token}">. Thiếu nó, POST trả 403 và không có log nào nói tại sao. Đừng tắt CSRF để “sửa” 403.
Với client JavaScript gọi API, dùng CookieCsrfTokenRepository.withHttpOnlyFalse() và gửi token qua header X-CSRF-TOKEN; đó là cấu hình cho SPA, không phải cho trang JSP.
Bảy lỗi hay gặp với JSP
- JSP không nằm trong jar. Chạy IDE hoặc
spring-boot:runthì được,java -jarthì 404 vì docBase là thư mục tạm. Sửa bằng WAR, hoặc chuyển template sang Thymeleaf. - Tên view lệch. Prefix đã là
/WEB-INF/views/mà controller trả"views/greeting"thì đường dẫn thành/WEB-INF/views/views/greeting.jsp. Trả"greeting.jsp"với suffix.jspthì thành.jsp.jsp. Tên file cũng phân biệt hoa thường trên Linux. - Thiếu JSTL. Lỗi The absolute URI: jakarta.tags.core cannot be resolved nghĩa là TLD không có trên classpath.
tomcat-embed-jasperkhông kèm JSTL; thêm API và implementation GlassFish như trong pom. - Đặt sai thư mục. JSP trong
src/main/resources/templateskhông được Jasper quét; nó phải nằm dướisrc/main/webapp. - Trộn
@RestController. Class có@RestControllertrả"greeting"sẽ ghi chuỗi đó ra body thay vì render view. View chỉ hoạt động với@Controller. - Còn
javax. Importjavax.servlet.*hoặc taglib URIhttp://java.sun.com/jsp/jstl/coretừ code cũ: cái đầu không compile, cái sau vẫn được JSTL 3.0 chấp nhận nhưng nên đổi sangjakarta.tags.coređể khỏi nợ về sau. - Scriptlet.
<% ... %>chèn Java thẳng vào view, bỏ qua mọi escape, và chỉ compile lúc chạy nên lỗi hiện ra ở production. Không viết scriptlet mới; file cũ có scriptlet thì coi như nợ kỹ thuật.
Quyết định 2026: JSP, Thymeleaf hay frontend riêng?
| Tình huống | Chọn | Vì sao |
|---|---|---|
| Dự án mới, UI server-side | Thymeleaf + spring-boot-starter-thymeleaf |
Đóng gói jar được, natural template, escape mặc định |
| Legacy JSP, sửa nhỏ | Giữ JSP + WAR | Chi phí migrate lớn hơn lợi ích ngắn hạn; dùng như cầu nối |
| UI phức tạp, nhiều team frontend | Frontend riêng + JSON API | Tách deploy, không qua ViewResolver |
| Báo cáo, email, PDF | Thymeleaf render off-request | Không cần servlet container cho template |
Sau khi trừ phương án bảo trì, JSP không còn cửa cho dự án mới. Nếu UI cần component phức tạp, tách frontend và để Spring trả JSON qua @RestController. Nếu chỉ cần trang quản trị đơn giản, Thymeleaf là lựa chọn rẻ nhất về vận hành.
Nhìn về 2027
JSP vẫn được duy trì trong Jakarta EE 11, nhưng không có tính năng mới nào khiến nó thành lựa chọn hấp dẫn hơn cho một view mới. Về phía Spring, Boot 4.2.0-RC2 và Framework 7.1.0-RC2 đang ở RC, chưa phát hành, và không có thay đổi nào liên quan JSP. Khoản đầu tư hợp lý cho 2027 là chuyển dần view sang Thymeleaf, hoặc tách frontend và API.
Checklist
- Xác nhận bài toán là legacy; nếu là dự án mới, chọn Thymeleaf hoặc frontend + API ngay từ đầu.
- WAR packaging,
tomcat-embed-jasperscopeprovided, JSTL API + GlassFish implementation. - JSP dưới
src/main/webapp/WEB-INF/views; prefix và suffix khớp tên view controller trả về. - Mọi dữ liệu người dùng đi qua
c:outhoặcfn:escapeXml; không còn scriptlet mới. - Form POST có token CSRF; kiểm tra bằng một request thiếu token để thấy 403.
Đọc tiếp Servlets là gì để hiểu nền tảng mà JSP dựa vào, Spring MVC giải mã để dựng app đầu tiên với Thymeleaf, các thành phần thiết yếu của ứng dụng Spring MVC để hiểu ViewResolver trong tổng thể, và Spring Boot Roadmap để đặt bài này vào đúng chặng.



