Spring Boot任务管理器/addTask接口出现404路径未找到问题

问题描述 #

使用Spring Boot开发任务管理器时，/tasks接口可正常工作，但调用/addTask接口出现404路径未找到错误，本地3232端口通过Postman请求时触发该问题，相关代码及配置如下：

控制器代码 #

package com.firstapp.taskManager.controller;

import com.firstapp.taskManager.DTO.CreateTaskDTO;
import com.firstapp.taskManager.DTO.TaskResponseDTO;
import com.firstapp.taskManager.Services.TaskService;
import com.firstapp.taskManager.entities.TaskEntity;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.text.ParseException;
import java.util.List;

@RestController
@RequestMapping("tasks")
public class TaskManagerController {
    private TaskService taskService;

    public TaskManagerController(TaskService taskService){
        this.taskService=taskService;
    }
    @GetMapping("")
    public ResponseEntity<List<TaskEntity>> getTask() {
        var task=taskService.getTask();
        return ResponseEntity.ok(task);
    }
    @GetMapping("/{id}")
    public ResponseEntity<TaskEntity> getTaskById(@PathVariable("id") Integer id) {
        var task = taskService.getTaskById(id);
        if (task == null) {
            return ResponseEntity.notFound().build();
        }
        return ResponseEntity.ok(task);
    }

    @PostMapping("")
    public ResponseEntity<TaskEntity> addTask(@RequestBody CreateTaskDTO body) throws ParseException {
        var task=taskService.addTask(body.getTitle(),body.getDescription(),body.getDeadline());
        return ResponseEntity.ok(task);
    }
}

Maven配置文件 #

<?xml version="1.0" encoding="UTF-8"?>
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.4</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.firstapp</groupId>
    <artifactId>taskManager</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>taskManager</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>

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

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.security</groupId>
            <artifactId>spring-security-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.project-lombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

问题原因及解决方案 #

核心问题 #

控制器中未定义/addTask路径的接口，当前添加任务的接口通过@PostMapping("")映射到/tasks路径（类上有@RequestMapping("tasks")），而你请求的是/addTask，因此返回404。

解决方式（二选一） #

1. 调整Postman请求路径：将请求地址改为POST http://localhost:3232/tasks，请求体传入符合CreateTaskDTO结构的JSON数据。
2. 修改控制器映射规则：若坚持使用/addTask路径，将@PostMapping("")改为@PostMapping("/addTask")，此时请求地址应为POST http://localhost:3232/tasks/addTask。

额外检查点 #

• 确认Spring Boot应用端口为3232，可通过application.properties/application.yml中的server.port=3232配置验证。
• 检查CreateTaskDTO是否有正确的getter方法，确保请求体JSON能正确绑定到DTO对象。
• 因依赖包含Spring Security，若开启默认安全配置，需在Postman中携带认证信息（如Basic Auth），但当前问题为404，优先级低于路径匹配问题。

内容的提问来源于stack exchange，提问作者Manjunatha reddy Lingamdinne