最直接有效的方式是使用 @Pattern 或 @URL 注解；@URL 仅校验基础格式，不验证可访问性，需严格控制时优先用 @Pattern 自定义正则，运行时解析校验应避免网络请求。
Spring Boot 中校验 URL 链接格式，最直接有效的方式是使用 @Pattern 或 @URL 注解，配合标准 Bean Validation 规则。注意：原生 @URL（来自 jakarta.validation.constraints.URL）仅校验基础格式（如含协议、域名结构），不验证可访问性或语义正确性；若需更严格控制（如限定协议为 https、禁止 IP 地址、排除特定域名），应优先用 @Pattern 自定义正则。
用 @URL 做基础格式校验
适用于快速判断是否符合通用 URL 结构（如 https://example.com/path?x=1）：
- 确保字段类型为
String（java.net.URL类型不被自动绑定且无法直接加注解） - 引入注解：
import jakarta.validation.constraints.URL;（Spring Boot 3+）或javax.validation.constraints.URL;（Spring Boot 2.x） - 示例：
public class LinkRequest { @URL(message = "链接格式不合法，请输入标准 URL（如 https://xxx.com）") private String targetUrl; // getter/setter } - Controller 中启用校验：
@Valid @RequestBody LinkRequest request
用 @Pattern 实现精准控制
当需要限制协议、子域名、端口或排除内网地址时，正则更可靠。例如只允许 HTTPS 开头、非 localhost 的公网域名：
- 推荐正则（兼顾可读与实用性）：
@Pattern( regexp = "^https://(?!(localhost|127\.0\.0\.1|::1))[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?)*\.[a-zA-Z]{2,}$", message = "请提供有效的 HTTPS 公网地址，不支持 localhost 或 IP 直连" ) - 若还需支持带路径和查询参数，可在末尾追加
(/[\w.:/?#[\]@!$&'()*+,;=-]*)? - 注意：正则不宜过度复杂，避免回溯攻击；建议在单元测试中覆盖典型用例（如
https://google.com、http://bad.com、https://192.168.1.1）
补充：运行时解析校验（非注解方式）
对极少数必须验证“是否真能解析为有效 URL”的场景（如存档链接有效性），可在 Service 层手动处理：
- 用
java.net.URI构造并检查组件：try { URI uri = new URI(urlString); if (!"https".equalsIgnoreCase(uri.getScheme()) && !"http".equalsIgnoreCase(uri.getScheme())) { throw new IllegalArgumentException("仅支持 http/https 协议"); } if (uri.getHost() == null) { throw new IllegalArgumentException("域名不能为空"); } } catch (URISyntaxException e) { throw new IllegalArgumentException("URL 格式错误", e); } - 不建议在 Controller 参数校验阶段做网络请求（如
HEAD检查可达性），会显著拖慢接口响应且违反校验边界职责
别忘了全局异常处理
校验失败默认返回 400 和冗长 JSON。建议统一拦截 MethodArgumentNotValidException，提取 FieldError 中的 defaultMessage ，返回简洁结构体（如 {"code":400,"msg":"链接格式不合法"}）。
