在 spring boot 中校验 url 地址，最直接且标准的方法是使用 hibernate validator 提供的 @url 注解。该注解会自动检查字符串是否符合 rfc 3986 定义的 uri 格式规范，包括协议、主机名和端口等部分。只需在实体类或 dto 的字段上添加此注解，spring boot 启动时便会自动注册相应的校验器，并在请求进入 controller 前拦截非法输入。
@URL 注解支持哪些具体的格式规则？
@URL 注解默认要求输入的字符串必须包含有效的协议（如 http 或 https）以及合法的主机名。它并不强制要求路径存在，但会严格校验域名结构的合法性，例如不允许出现连续的两个点号。如果业务场景只需要校验域名而不需要协议，或者需要更严格的完整 URL 校验，则需要结合正则表达式或自定义校验逻辑来实现。
import jakarta.validation.constraints.URL;
public class LinkDTO {
@URL(message = "Invalid URL format")
private String websiteUrl;
}
当使用上述代码并传入 http://example.com 时，校验通过；若传入 not-a-url，则触发校验失败。该注解内部依赖于 Java 的 java.net.URI 类进行解析，因此其兼容性取决于 JDK 版本对 URI 规范的实现。
如何自定义校验以支持特定协议或忽略协议头？
默认的 @URL 注解可能过于宽松或严格，具体取决于项目需求。例如，某些内部系统只接受 HTTPS 链接，或者允许不带协议的相对路径。此时可以通过编写自定义注解并结合正则表达式来实现精确控制。自定义注解可以继承 ConstraintValidator 接口，在其中注入特定的校验逻辑，从而覆盖默认行为。
import java.util.regex.Pattern;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
public class StrictHttpsValidator implements ConstraintValidator<StrictHttps, String> {
private static final Pattern PATTERN = Pattern.compile("^https://[a-zA-Z0-9.-]+$");
@Override
public boolean isValid(String value, ConstraintValidatorContext context) {
if (value == null) return true;
return PATTERN.matcher(value).matches();
}
}
使用这个自定义注解 @StrictHttps 后，只有以 https:// 开头且后续为有效域名的字符串才会被接受。这种方案比 @URL 更灵活，能够应对复杂的业务规则，如禁止 IP 地址直接作为主机名，或限制子域名层级。
当 URL 中包含特殊字符或中文时校验会失败吗？
标准的 @URL 注解在处理包含非 ASCII 字符（如中文）的 URL 时，通常会在编码阶段就要求开发者预先进行 Percent-Encoding（百分号编码）。如果直接传入未编码的中文字符串，校验通常会失败，因为 java.net.URI 构造函数在严格模式下会拒绝非法字符。为了确保校验通过，必须在调用校验逻辑之前，使用 URLEncoder.encode() 对 URL 中的特殊部分进行编码。此外，对于国际化域名（IDN），JDK 8+ 提供了更好的支持，但仍建议显式处理编码问题以避免不可预知的异常。
