<think>好的，用户问的是当
Controller和启动类不在同
一个模块下，包已经被
扫描到了，但请求返回404的问题。首先，我需要回忆一下
Spring Boot的组件
扫描机制。默认情况下，
启动类所在的包及其子包会被自动
扫描，所以如果
Controller在同
一个模块但不同包下，可能需要配置scanBasePackages。但用户说他们已经在不同的模块，但包被
扫描到了，所以问题可能出在其他地方。
首先，用户可能已经正确配置了scanBasePackages或者scanBasePackageClasses，确保
Controller所在的包被包含。不过即使包被
扫描到，仍然404，可能有其他原因。比如，
Controller类是否有正确的注解，比如@Rest
Controller或@
Controller。或者方法上的@RequestMapping是否正确，路径是否正确。
其次，模块之间的依赖关系是否正确。如果
Controller在另
一个模块，那么启动模块是否添加了对该模块的依赖？比如Maven或Gradle中是否有正确的依赖配置，否则即使包路径被
扫描，类可能没有被正确加载。
然后，检查包结构是否正确。虽然scanBasePackages指定了包，但如果模块的打包方式有问题，比如jar包没有正确包含
Controller类，或者构建时没有包含该模块，导致运行时找
不到类。
另外，可能需要检查是否多个模块中有同名的Bean导致冲突，或者是否有过滤器、拦截器拦截了请求，导致请求没有被正确路由。
还有，检查应用的启动日志，看是否有
Controller被成功注册的日志信息。
Spring Boot启动时会输出映射的端点，如果
Controller的方法没有被注册，日志里会有线索。
用户提到包能
扫描到，可能已经确认了组件
扫描的配置正确，但需要排除其他可能性。比如，请求的URL是否正确，是否有拼写错误，或者方法上的HTTP方法不匹配（比如用GET访问POST接口）。
还有可能，应用上下文没有正确加载，比如多模块
项目中使用
Spring Boot的打包方式，主类没有正确识别其他模块的配置。
总结可能的解决步骤：1. 检查依赖是否正确；2. 确认
Controller注解
和路径正确；3. 查看启动日志中的映射信息；4. 确保模块打包
和类路径正确；5. 检查是否有其他配置覆盖或拦截请求。</think>在
Spring Boot 多模块
项目中，如果
Controller 和启动类不在同一模块且请求返回 **404**，即使包路径已配置
扫描，仍需按以下步骤排查：
---
### **1. 确认组件
扫描配置**
- **`scanBasePackages` 是否包含
Controller 所在包**：
```java
@
SpringBootApplication(scanBasePackages = "com.module.
controller") // 明确指向
Controller 所在包
public class MainApplication { ... }
```
- 若通过 `scanBasePackageClasses` 配置，确保类位于
Controller 所在包下。
---
### **2. 验证模块依赖**
- **检查模块间依赖关系**：
启动类所在模块的构建文件（如 `pom.xml` 或 `build.gradle`）必须依赖
Controller 所在模块。
**Maven 示例**：
```xml
<dependency>
<groupId>com.example</groupId>
<artifactId>
controller-module</artifactId>
<version>1.0.0</version>
</dependency>
```
---
### **3. 检查
Controller 定义**
- **注解是否正确**：
Controller 类需标注 `@Rest
Controller` 或 `@
Controller`。
- **路径映射是否生效**：方法需标注 `@RequestMapping` 及其衍生注解（如 `@GetMapping`）。
```java
@Rest
Controller // 确保注解存在
public class Demo
Controller {
@GetMapping("/test") // 路径不要拼写错误
public String test() { return "OK"; }
}
```
---
### **4. 查看启动日志**
- 启动应用时，搜索日志中的 **`RequestMappingHandlerMapping`**，确认
Controller 的 URL 映射已注册：
```
Mapped "{[/test], methods=[GET]}" onto public java.lang.String Demo
Controller.test()
```
- 若未找到此日志，说明
Controller **未被
扫描或加载**。
---
### **5. 排查打包问题**
- **打包方式**：确保
Controller 所在模块已正确打包，并被主模块依赖的最终产物（如 JAR）包含。
- **类路径检查**：解压最终生成的 JAR 包，确认 `com/module/
controller/Demo
Controller.class` 存在。
---
### **6. 其他可能原因**
- **静态资源冲突**：若请求路径与静态资源（如 `static/test.html`）重名，优先返回静态资源。
- **拦截器或过滤器拦截**：检查是否
自定义了拦截器，错误拦截了请求。
- **上下文路径配置**：检查 `server.servlet.context-path`，实际访问路径需包含此前缀（如 `/api/test`）。
---
### **验证流程图**
```mermaid
graph TD
A[请求404] --> B{组件
扫描配置正确?}
B -->|是| C{模块依赖正确?}
B -->|否| H[修正 scanBasePackages]
C -->|是| D{
Controller 注解
和路径正确?}
C -->|否| I[添加模块依赖]
D -->|是| E{日志中映射存在?}
D -->|否| J[修正注解或路径]
E -->|是| F{打包包含
Controller?}
E -->|否| K[检查类加载问题]
F -->|是| G[排查拦截器/过滤器]
F -->|否| L[修正打包配置]
```
扫一扫
2185
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
