新增服务访问 404 问题解决指南

📋 问题描述

当你按照文档的 《完成微服务增删改查》 教程新增 demo 服务后，访问接口时出现 404 错误，提示资源不存在。

🔍 排查步骤

第零步：检查实际请求地址

在排查问题之前，建议先通过浏览器开发者工具查看实际的请求信息 URL 。

操作步骤：

1. 打开浏览器，按 F12 打开开发者工具
2. 切换到 Network（网络） 标签页
3. 重新发起请求，观察网络请求记录
4. 点击具体的请求，查看详细信息

检查要点：Request URL（请求地址）：确认实际发送的URL是否正确

第一步：检查网关路由配置

网关是所有请求的入口，首先需要确认路由配置是否正确。

检查要点：

1. 登录管理后台，进入 系统管理 → 路由管理
2. 确认你的新服务路由是否已添加
3. 检查路由前缀是否与实际请求路径匹配

示例说明：

• 如果你的服务名是 demo，路由前缀应该是 /demo/**
• 请求地址应该是 http://网关地址/demo/你的接口路径

第二步：检查接口配置

如果网关路由正确，接下来检查你的代码接口路径。

🔧 具体检查清单

1. 检查 Controller 类的注解

@RestController  // 必须有这个注解
@RequestMapping("/demo")  // 检查路径是否正确
public class DemoController {
    // 你的接口代码
}

2. 检查接口方法的注解

@GetMapping("/list")  // 或 @PostMapping, @PutMapping 等
public Result list() {
    // 接口逻辑
}

3. 检查包结构是否正确

确保你的 Controller 类在正确的包路径下：

重要提醒

Spring Boot 有默认的组件扫描规则：只会扫描启动类（Main方法所在类）的包及其子包！

举例说明：

• 启动类位置：com.pig4cloud.demo.DemoApplication
• 可以扫描到：com.pig4cloud.demo.* 下的所有类
• 扫描不到：com.pig4cloud.other.* 下的类

🚀 验证步骤

完成修改后，按以下步骤验证：

1. 重启服务：确保代码修改生效
2. 检查日志：查看服务启动日志，确认 Controller 被正确加载
3. 测试接口：使用 Postman 或浏览器测试接口访问
4. 查看网关日志：如果还有问题，检查网关转发日志