Spring Boot：无法访问本地主机上的 REST 控制器 (404)

Question

我正在尝试改编 Spring Boot 网站上的 REST 控制器示例。 不幸的是，当我尝试访问 localhost:8080/item URL 时，出现以下错误。

{
  "timestamp": 1436442596410,
  "status": 404,
  "error": "Not Found",
  "message": "No message available",
  "path": "/item"
}

POM：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <groupId>SpringBootTest</groupId>
   <artifactId>SpringBootTest</artifactId>
   <version>0.0.1-SNAPSHOT</version>
   <properties>
      <javaVersion>1.8</javaVersion>
      <mainClassPackage>com.nice.application</mainClassPackage>
      <mainClass>${mainClassPackage}.InventoryApp</mainClass>
   </properties>

   <build>
      <plugins>
         <plugin>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.3</version>
            <configuration>
               <source>${javaVersion}</source>
               <target>${javaVersion}</target>
            </configuration>
         </plugin>

         <!-- Makes the Spring Boot app executable for a jar file. The additional configuration is needed for the cmd: mvn spring-boot:repackage 
            OR mvn spring-boot:run -->
         <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>

            <configuration>
               <mainClass>${mainClass}</mainClass>
               <layout>ZIP</layout>
            </configuration>
            <executions>
               <execution>
                  <goals>
                     <goal>repackage</goal>
                  </goals>
               </execution>
            </executions>
         </plugin>

         <!-- Create a jar with a manifest -->
         <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>2.4</version>
            <configuration>
               <archive>
                  <manifest>
                     <mainClass>${mainClass}</mainClass>
                  </manifest>
               </archive>
            </configuration>
         </plugin>
      </plugins>
   </build>

   <dependencyManagement>
      <dependencies>
         <dependency>
            <!-- Import dependency management from Spring Boot. This replaces the usage of the Spring Boot parent POM file. -->
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>1.2.5.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
         </dependency>

         <!-- more comfortable usage of several features when developing in an IDE. Developer tools are automatically disabled when 
            running a fully packaged application. If your application is launched using java -jar or if it’s started using a special classloader, 
            then it is considered a 'production application'. Applications that use spring-boot-devtools will automatically restart whenever files 
            on the classpath change. -->
         <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
         </dependency>
      </dependencies>
   </dependencyManagement>

   <dependencies>
      <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-web</artifactId>
      </dependency>

      <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-test</artifactId>
         <scope>test</scope>
      </dependency>

      <dependency>
         <groupId>com.google.guava</groupId>
         <artifactId>guava</artifactId>
         <version>15.0</version>
      </dependency>
   </dependencies>
</project>

Starter-Application：

package com.nice.application;
@SpringBootApplication // same as @Configuration @EnableAutoConfiguration @ComponentScan
public class InventoryApp {
   public static void main( String[] args ) {
      SpringApplication.run( InventoryApp.class, args );
   }
}

REST-Controller：

package com.nice.controller; 
@RestController // shorthand for @Controller and @ResponseBody rolled together
public class ItemInventoryController {
   public ItemInventoryController() {
   }

   @RequestMapping( "/item" )
   public String getStockItem() {
      return "It's working...!";
   }

}

我正在使用 Maven 构建这个项目。 将其作为 jar (spring-boot:run) 启动，并在 IDE (Eclipse) 中启动。

控制台日志：

2015-07-09 14:21:52.132  INFO 1204 --- [           main] c.b.i.p.s.e.i.a.InventoryApp          : Starting InventoryApp on 101010002016M with PID 1204 (C:\eclipse_workspace\SpringBootTest\target\classes started by MFE in C:\eclipse_workspace\SpringBootTest)
2015-07-09 14:21:52.165  INFO 1204 --- [           main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@7a3d45bd: startup date [Thu Jul 09 14:21:52 CEST 2015]; root of context hierarchy
2015-07-09 14:21:52.661  INFO 1204 --- [           main] o.s.b.f.s.DefaultListableBeanFactory     : Overriding bean definition for bean 'beanNameViewResolver': replacing [Root bean: class [null]; scope=; abstract=false; lazyInit=false; autowireMode=3; dependencyCheck=0; autowireCandidate=true; primary=false; factoryBeanName=org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration$WhitelabelErrorViewConfiguration; factoryMethodName=beanNameViewResolver; initMethodName=null; destroyMethodName=(inferred); defined in class path resource [org/springframework/boot/autoconfigure/web/ErrorMvcAutoConfiguration$WhitelabelErrorViewConfiguration.class]] with [Root bean: class [null]; scope=; abstract=false; lazyInit=false; autowireMode=3; dependencyCheck=0; autowireCandidate=true; primary=false; factoryBeanName=org.springframework.boot.autoconfigure.web.WebMvcAutoConfiguration$WebMvcAutoConfigurationAdapter; factoryMethodName=beanNameViewResolver; initMethodName=null; destroyMethodName=(inferred); defined in class path resource [org/springframework/boot/autoconfigure/web/WebMvcAutoConfiguration$WebMvcAutoConfigurationAdapter.class]]
2015-07-09 14:21:53.430  INFO 1204 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat initialized with port(s): 8080 (http)
2015-07-09 14:21:53.624  INFO 1204 --- [           main] o.apache.catalina.core.StandardService   : Starting service Tomcat
2015-07-09 14:21:53.625  INFO 1204 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet Engine: Apache Tomcat/8.0.23
2015-07-09 14:21:53.731  INFO 1204 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2015-07-09 14:21:53.731  INFO 1204 --- [ost-startStop-1] o.s.web.context.ContextLoader            : Root WebApplicationContext: initialization completed in 1569 ms
2015-07-09 14:21:54.281  INFO 1204 --- [ost-startStop-1] o.s.b.c.e.ServletRegistrationBean        : Mapping servlet: 'dispatcherServlet' to [/]
2015-07-09 14:21:54.285  INFO 1204 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean  : Mapping filter: 'characterEncodingFilter' to: [/*]
2015-07-09 14:21:54.285  INFO 1204 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean  : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]
2015-07-09 14:21:54.508  INFO 1204 --- [           main] s.w.s.m.m.a.RequestMappingHandlerAdapter : Looking for @ControllerAdvice: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@7a3d45bd: startup date [Thu Jul 09 14:21:52 CEST 2015]; root of context hierarchy
2015-07-09 14:21:54.573  INFO 1204 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error]}" onto public org.springframework.http.ResponseEntity<java.util.Map<java.lang.String, java.lang.Object>> org.springframework.boot.autoconfigure.web.BasicErrorController.error(javax.servlet.http.HttpServletRequest)
2015-07-09 14:21:54.573  INFO 1204 --- [           main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error],produces=[text/html]}" onto public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest)
2015-07-09 14:21:54.594  INFO 1204 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2015-07-09 14:21:54.594  INFO 1204 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2015-07-09 14:21:54.633  INFO 1204 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2015-07-09 14:21:54.710  INFO 1204 --- [           main] o.s.j.e.a.AnnotationMBeanExporter        : Registering beans for JMX exposure on startup
2015-07-09 14:21:54.793  INFO 1204 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
2015-07-09 14:21:54.795  INFO 1204 --- [           main] c.b.i.p.s.e.i.a.InventoryApp          : Started InventoryApp in 2.885 seconds (JVM running for 3.227)
2015-07-09 14:22:10.911  INFO 1204 --- [nio-8080-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring FrameworkServlet 'dispatcherServlet'
2015-07-09 14:22:10.911  INFO 1204 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : FrameworkServlet 'dispatcherServlet': initialization started
2015-07-09 14:22:10.926  INFO 1204 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : FrameworkServlet 'dispatcherServlet': initialization completed in 15 ms

到目前为止我尝试过的操作：

• 使用应用程序名称 (InventoryApp) 访问 URL
• 将另一个 @RequestMapping("/") 放在 ItemInventoryController 的类级别

据我了解，使用 Spring Boot 时我不需要应用程序上下文。我说得对吗？

我还能做什么来通过 URL 访问该方法？

Answer 1

尝试将以下内容添加到您的 InventoryApp 类中

@SpringBootApplication
@ComponentScan(basePackageClasses = ItemInventoryController.class)
public class InventoryApp {
...

spring-boot 将扫描 com.nice.application 下面的包中的组件，因此，如果您的控制器位于 com.nice.controller 中，您需要明确扫描它。

Answer 2

添加到 MattR 的答案：

如此处所述，@SpringBootApplication会自动插入所需的注解：@Configuration、@EnableAutoConfiguration 以及@ComponentScan；但是，@ComponentScan 只会查找与应用程序位于同一包中的组件，在本例中为您的 com.nice.application，而您的控制器位于 com.nice.controller。这就是为什么您会收到 404 错误，因为应用程序在 application 包中找不到控制器。

Answer 3

使用以下代码

@Controller
@RequestMapping("/duecreate/v1.0")
public class DueCreateController {

}

响应执行服务后，我得到了相同的 404 响应：

{
"timestamp": 1529692263422,
"status": 404,
"error": "Not Found",
"message": "No message available",
"path": "/duecreate/v1.0/status"
}

将其更改为以下代码后，我收到了正确的响应

@RestController
@RequestMapping("/duecreate/v1.0")
public class DueCreateController {

}

响应：

{
"batchId": "DUE1529673844630",
"batchType": null,
"executionDate": null,
"status": "OPEN"
}

Answer 4

有两种方法可以克服这个问题

1. 将启动应用程序放在包结构的开头并将所有控制器放在其中。

   示例：

   包com.spring.boot.app； - 启动应用程序（即主方法 -SpringApplication.run(App.class, args);）

   您使用相同的包结构来休息控制器
   例子 ：
   package com.spring.boot.app.rest;

2. 在 Bootup 包中显式定义控制器。

方法1更干净。

Answer 5

SpringBoot 开发人员建议将主应用程序类放置在根包中其他类之上。使用根包还允许使用 @ComponentScan 注释，而无需指定 basePackage 属性。 详细信息
但请确保自定义根包存在。

Answer 6

控制器应该可以在同一命名空间中访问
这就是你所拥有的

应该是这样，查看命名空间的层次结构

Answer 7

我遇到了这个问题，您需要做的是修复您的软件包。如果您从 http://start.spring.io/ 下载此项目，那么您的主类位于某些包裹。例如，如果主类的包是：“com.example”，那么您的控制器必须位于包：“com.example.controller”中。希望这有帮助。

Answer 8

您需要修改 Starter-Application 类，如下所示。

@SpringBootApplication

@EnableAutoConfiguration

@ComponentScan(basePackages="com.nice.application")

@EnableJpaRepositories("com.spring.app.repository")

public class InventoryApp extends SpringBootServletInitializer {..........

并更新控制器、服务和存储库包结构，如下所述。

例子：
REST-Controller

package com.nice.controller; -->必须将其修改为
package com.nice.application.controller;

您需要为 Spring Boot MVC 流程中的所有包遵循正确的包结构。

因此，如果您正确修改项目捆绑包结构，那么您的 Spring Boot 应用程序将正常工作。

Answer 9

Springboot 新手，尝试了上面的所有内容，但最终就像我在浏览器上的 URL 末尾有一个 / 一样简单，而我唯一的 Get() 方法是空白的，只返回一个字符串。
希望有一天这会对某人有所帮助。

Answer 10

将 @RequestMapping( "/item" ) 替换为 @GetMapping(value="/item", Produce=MediaType.APPLICATION_JSON_VALUE)。

也许它会对某人有所帮助。

Answer 11

对我来说，

当我将 spring-web 替换为 spring-boot-starter-web 时，我将 spring-web 而不是 spring-boot-starter-web 添加到我的 pom.xml 中，所有映射都显示在控制台日志中。

Answer 12

我发现了一个非常适合这个问题的主题。

https://coderanch.com/t/735307/frameworks/Spring- boot-Rest-api

控制器api应该位于子目录结构中，以自动检测控制器。否则可以使用注释参数。

@SpringBootApplication(scanBasePackages = {"com.example.demo", "com.example.Controller"})

Answer 13

我认为还值得注意的是，项目的绝对路径很重要（在我的例子中，它位于 Windows 计算机上）。我遇到了类似的问题，我重组了我的项目，确保在必要时有 @Controller 或 @RestController 。我确保我正确命名了我的路径，但不知怎的，我总是得到一个白色标签错误页面，当我退后一步时，我意识到我有空格和特殊字符我的项目绝对路径中的某个点，因此我将同一个项目移动到一个新目录，其中文件夹名称中的任何点都没有空格和/或特殊字符并且它有效。

Answer 14

我有完全相同的错误，我没有提供基础包。给出正确的基础包，解决了它。

package com.ymc.backend.ymcbe;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.ComponentScan;

@SpringBootApplication
@ComponentScan(basePackages="com.ymc.backend")
public class YmcbeApplication {

    public static void main(String[] args) {
        SpringApplication.run(YmcbeApplication.class, args);
    }

}

注意：不包括.controller
@ComponentScan(basePackages="com.ymc.backend.controller") 因为我
如果我有许多其他组件类，我的项目不会扫描这些组件类
只需给.controller

这是我的控制器示例：

package com.ymc.backend.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;


@RestController
@CrossOrigin
@RequestMapping(value = "/user")
public class UserController {

    @PostMapping("/sendOTP")
    public String sendOTP() {
        return "OTP sent";
    };


}

Answer 15

有时 Spring Boot 的行为很奇怪。我在应用程序类中指定如下并且它有效：

@ComponentScan("com.seic.deliveryautomation.controller")

Answer 16

由于网址区分大小写，我遇到了 404 问题。

例如
@RequestMapping(value = "/api/getEmployeeData",method = RequestMethod.GET) 应使用 http://www.example.com/api/getEmployeeData 访问。如果我们使用 http://www.example.com/api/getemployeedata，我们会收到 404 错误。

笔记：
http://www.example.com 只是我上面提到的参考。它应该是您托管应用程序的域名。

经过一番努力并应用本文中的所有其他答案后，我发现问题仅在于该网址。这可能是一个愚蠢的问题。但这花了我2个小时。所以我希望它能帮助别人。

Answer 17

如果我们按如下方式使用它也可以工作：

@SpringBootApplication(scanBasePackages = { "<class ItemInventoryController package >.*" })

Answer 18

可能是其他程序正在端口 8080 上运行，而您实际上错误地连接到了它。

一定要检查一下，特别是如果您有码头工人正在启动您无法控制的其他服务，并且正在端口转发这些服务。

Answer 19

问题出在你的包结构上。 Spring Boot应用程序有一个特定的包结构，允许spring上下文扫描并加载其上下文中的各种bean。

在 com.nice.application 中是您的主类所在的位置，在 com.nice.controller 中是您的控制器类。

将 com.nice.controller 包移至 com.nice.application 中，以便 Spring 可以访问您的 bean。

Answer 20

另一个解决方案，以防有帮助：就我而言，问题是我在类级别（在我的控制器中）有一个 @RequestMapping("/xxx") ，并且在公开的服务中我有 <代码>@PostMapping (value = "/yyyy") 和@GetMapping (value = "/zzz");一旦我评论了 @RequestMapping("/xxx") 并在方法级别管理了所有内容，就像魅力一样。

Answer 21

对我来说，问题是我设置的应用程序总是在启动后立即关闭。因此，当我尝试是否可以访问控制器时，应用程序已不再运行。
立即关闭的问题在 此中解决线程。

Answer 22

@SpringBootApplication
@ComponentScan(basePackages = {"com.rest"}) // basePackageClasses = HelloController.class)
// 使用上面的组件扫描来添加包
公共类 RestfulWebServicesApplication {

public static void main(String[] args) {
    SpringApplication.run(RestfulWebServicesApplication.class, args);
}

}

Answer 23

可能有3个原因导致此错误：

1>

检查您请求的网址是否正确

2>检查你的

使用MVC，然后使用@Controller，否则使用@RestController

3>查看

您是否将控制器包（或类）放置在根目录之外
包示例：com.example.demo ->是你的主要
包

将控制器包放入 com.example.demo.controller

Answer 24

我遇到了同样的问题，因为我创建了一个用 @Configuration 注释的内部类，并且它以某种方式禁止组件扫描。

Answer 25

我遇到了同样的问题，虽然上述解决方案本身是正确的，但它们对我不起作用，我发现了另一个可能的原因来解决它 - 你必须从端口关闭应用程序，然后重新启动你的应用程序，如果执行 Maven 更新或项目清理未能解决该问题。

简而言之，打开命令提示符，然后运行以下两个命令：

netstat -ano | findstr :8080

此命令将找到附加在您的应用程序运行的端口上的进程 ID - 如果您在除默认。

您将得到以下输出：

您关心的是最后一列中的数字，它是与运行应用程序实例的端口关联的进程 ID。

如果您使用 STS4 进行开发，您还可以在控制台的顶部边缘看到 PID，但您必须眯着眼睛才能找到它：

在此处输入图像描述"> 此时，运行下一个命令杀死过程：

taskkill /pid 22552 /f

结果如下：

请记住，每次运行应用程序时都会有不同的 PID。

最后，您可以再次运行它，这样就可以了。

更多相关资料：
关闭网络连接

以编程方式关闭 SpringBoot 应用

Answer 26

就我而言，主应用程序类位于根包中，仍然收到白标签错误页面，未找到 404，首先 设置记录所有路由，查看 url 是否正确，然后在 eclipse 运行配置 中检查 spring boot 启用调试输出< /代码>,它会记录详细的servlet转发过程，错误日志是

View name 'discuss', model 
Forwarding to [discuss]
"FORWARD" dispatch for GET "/discuss", parameters={}
Resource not found

discuss.html正确放置在main\resources\templates中，尝试了几分钟，发现html正在使用< code>thymeleaf 但 pom.xml 没有依赖项，添加 thymeleaf 依赖项后已修复。

Answer 27

将返回类型从 String 更改为 ResponseEntity

Like : 
@RequestMapping( "/item" )
public ResponseEntity<String> getStockItem() {
        return new ResponseEntity<String>("It's working...!", HttpStatus.OK);
}

Answer 28

将您的 springboot 应用程序类放在根包中，例如，如果您的服务、控制器位于 springBoot.xyz 包中，那么您的主类应该位于 springBoot 包中，否则它将不会扫描以下包

Answer 29

可以在POM里面添加。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <version>XXXXXXXXX</version>
</dependency>