故障现象 某SpringBoot开发的接口服务，启动过程无任何报错，控制台显示服务正常启动，端口监听正常，但通过Postman或浏览器访问接口时，始终返回404 Not Found，接口无法正常响应，涉及用户登录、订单查询等核心接口，影响开发进度。
### 问诊分析 结合SpringBoot接口开发规范，排查方向聚焦于包扫描、注解使用、请求路径配置三个核心维度，逐步定位问题：
1. 包扫描范围不足：SpringBoot默认扫描启动类所在包及其子包下的组件，排查发现，Controller类所在的包不在启动类的扫描范围内，导致Controller未被Spring容器注册，接口无法被识别，进而返回404。例如，启动类位于com.example.pharmacy包下，而Controller类位于com.example.api包下，未被自动扫描。
2. 注解使用错误：检查Controller类，发现部分接口未添加@RestController或@Controller注解，导致Spring无法识别该类为控制器；部分接口方法仅添加了@RequestMapping注解，但未指定请求方式（GET/POST），且请求路径存在大小写错误（SpringBoot请求路径默认区分大小写），导致请求路径不匹配。
3. 静态资源与接口路径冲突：项目中静态资源（如HTML、CSS文件）放在src/main/resources/static目录下，而接口路径与静态资源路径重名（如接口路径为/api/index，静态资源有index.html），导致SpringBoot优先匹配静态资源，接口无法被正确路由，返回404。
4. 配置文件异常：检查application.yml配置，发现配置了server.servlet.context-path=/api，但接口请求时未添加该上下文路径，导致请求路径不完整，无法匹配到对应的接口。
### 解决方案 针对上述问题，逐一修复，确保接口正常访问：
1. 调整包扫描范围：将Controller类移动到启动类所在包及其子包下，或在启动类上添加@ComponentScan注解，指定扫描范围，例如@ComponentScan(basePackages = {"com.example.pharmacy", "com.example.api"})，确保Controller被Spring容器注册。
2. 修正注解使用：给所有Controller类添加@RestController注解（返回JSON数据），接口方法添加对应的请求方式注解（@GetMapping、@PostMapping），规范请求路径，确保路径大小写、斜杠拼接正确，避免路径错误。例如，将@RequestMapping("/userLogin")改为@PostMapping("/userLogin")，确保请求方式与前端一致。
3. 避免路径冲突：修改接口路径或静态资源名称，确保接口路径与静态资源路径不重名；若需保留重名路径，可通过配置SpringBoot静态资源访问规则，区分静态资源和接口请求。
4. 完善请求路径：若配置了server.servlet.context-path，请求接口时需在路径前添加该上下文路径，例如配置为/server.servlet.context-path=/api，接口请求路径应为http://localhost:8080/api/userLogin。
### 规避技巧 1. 开发接口时，严格遵循SpringBoot规范，确保Controller类在包扫描范围内，注解使用正确； 2. 接口路径命名采用统一规范（如全小写、用下划线分隔），避免大小写错误和路径冲突； 3. 配置上下文路径后，及时同步给前端开发人员，确保请求路径正确； 4. 接口开发完成后，先通过Postman测试接口可用性，再进行后续联调，及时发现路径和注解问题。
