Spring Boot REST API 认证与数据关联故障修复开源项目

面向需要接手和修复现有 Java、Spring Boot REST 后端的场景，对认证失败、接口契约与实体关系持久化异常进行复现、分级诊断和范围化修复，并通过自动化测试与真实 HTTP 调用验证修复结果。

案例基于 Apache 2.0 许可的 Spring PetClinic REST 公开项目，在同一代码版本中复现并修复两项后端阻塞问题：新建用户因密码编码链路不一致导致认证返回 401；Pet 创建因 ownerId 请求契约和实体关系映射缺失导致持久化失败。修复后完成用户创建与认证、Pet 创建与 Owner 关联查询、无效 Owner 404 等回归，并明确保留非阻塞警告、无关错误映射和外部数据库迁移为后续范围。

项目使用 Java 17、Spring Boot 3.2.1 与 Maven Wrapper，采用 Spring Web REST API、Spring Data JPA/Hibernate 和 Spring Security Basic Authentication。认证修复统一使用 DelegatingPasswordEncoder，并同步调整 HSQLDB、MySQL、PostgreSQL schema 的密码字段长度；数据关联修复补充 ownerId 请求契约、Owner 查询校验和 MapStruct 关系映射。实际验收使用 HSQLDB，通过 JUnit 5、MockMvc、Spring Security Test、AssertJ 和 Mockito 完成专项回归 3/3、全量测试 183/183，Maven clean verify 为 BUILD SUCCESS，并重新执行真实 HTTP 调用验证 201/200/401/404 等行为。