本文详解如何在 Java Servlet 中通过 @WebServlet 注解支持含多个路径占位符（如 /organization/{orgId}/location/{locId}）的 RESTful URL，并修正因数组索引错误导致的 404 问题。
本文详解如何在 java servlet 中通过 `@webservlet` 注解支持含多个路径占位符（如 `/organization/{orgid}/location/{locid}`）的 restful url，并修正因数组索引错误导致的 404 问题。
在构建基于 Servlet 的轻量级 REST API 时，常需通过 URL 路径传递多个动态参数，例如获取某组织下特定位置的详情：/organization/5/location/50。虽然 @WebServlet 支持通配符模式（如 "/organization/*/location/*"），但它不提供结构化路径变量（如 Spring MVC 的 @PathVariable），所有参数需手动从 request.getPathInfo() 解析——而此处极易因忽略路径分割后的数组索引偏移导致逻辑错误。
关键问题在于：request.getPathInfo() 返回的是以 / 开头的子路径字符串（例如 /organization/5/location/50），调用 .split("/") 后会生成一个以空字符串开头的数组：
// 对于请求路径 /organization/5/location/50
String pathInfo = request.getPathInfo(); // 值为 "/organization/5/location/50"
String[] parts = pathInfo.split("/"); // 结果：["", "organization", "5", "location", "50"]
// 注意：parts[0] 是空字符串，有效段从索引 1 开始
因此，原代码中 pathInfo[2]（取 "5"）看似合理，实则依赖错误假设；而 pathInfo[4]（期望 "50"）在该数组中实际为 parts[4] ——但前提是数组长度至少为 5。然而，split("/") 在末尾无斜杠时不会产生额外空项，所以上述示例中 parts.length == 5，而非原文误判的 4。
✅ 正确做法是：
- 先校验
pathInfo非空且符合预期格式； - 使用
Arrays.stream(parts).filter(s -> !s.isEmpty()).toArray(String[]::new)清洗空项，或直接按固定位置安全访问； - 更健壮的写法是基于已知路径结构定位：
organizationId总在第 2 段（索引 2），locationId总在第 4 段（索引 4）——但需确保parts.length >= 5。
以下是修正后的生产就绪代码（含边界检查与清晰注释）：
import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/organization/*/location/*")
public class LocationServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
String pathInfo = request.getPathInfo();
if (pathInfo == null || pathInfo.trim().isEmpty()) {
response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
response.getWriter().write("Missing path information");
return;
}
String[] parts = pathInfo.split("/");
// 过滤掉空字符串，获得纯净路径段：["organization", "5", "location", "50"]
String[] cleanParts = java.util.Arrays.stream(parts)
.filter(s -> !s.isEmpty())
.toArray(String[]::new);
if (cleanParts.length != 4 ||
!"organization".equals(cleanParts[0]) ||
!"location".equals(cleanParts[2])) {
response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
response.getWriter().write("Invalid URL format. Expected: /organization/{id}/location/{id}");
return;
}
String organizationId = cleanParts[1];
String locationId = cleanParts[3];
// ✅ 安全获取参数，避免 IndexOutOfBoundsException
response.setContentType("text/plain;charset=UTF-8");
response.getWriter().printf("Organization ID: %s, Location ID: %s", organizationId, locationId);
}
}
⚠️ 重要注意事项：
-
@WebServlet的通配符*仅匹配单段路径（不能跨段或匹配斜杠），因此/organization/*/location/*可匹配/organization/5/location/50，但无法匹配/organization/5/subunit/10/location/50； - 若需更灵活的路由（如正则匹配、嵌套参数、自动类型转换），建议迁移到现代框架（如 Spring Boot +
@GetMapping("/organization/{orgId}/location/{locId}")）； - 生产环境务必对
organizationId和locationId做合法性校验（如是否为数字、长度限制、SQL/命令注入防护）； - 避免在响应中直接拼接用户输入，尤其当后续对接数据库或外部服务时。
综上，解决多占位符 URL 的核心在于：理解 getPathInfo() 的返回值结构、正确处理 split("/") 的空首项、并建立健壮的路径段断言逻辑。通过上述修正，即可稳定支持形如 /organization/{orgId}/location/{locId} 的双参数 REST 接口。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
