關於存取後端介面報404錯誤問題的解決方法(全網最細!)

2023-09-06 22:06:59

情況一：server.servlet.context-path(專案存取路徑)漏寫或者名稱寫錯
情況二：類上面的@RequestMapping(“/demo”)註解裡面的值漏寫或者名稱寫錯
情況三：方法上面的@RequestMapping(“/demo”)註解裡面的值漏寫或者名稱寫錯
情況四：路徑多寫了一部分內容

第二點後端介面的返回值是否能夠對映到前端頁面

總結

前言

當我們通過前端向後端發起一個請求呼叫後端介面時，經常會遇到404的問題。網上關於對404問題介紹的一大堆，其實404問題的本質就兩點。

在介紹404問題之前先溫習一個小的知識點——專案存取路徑
專案存取路徑：就是定位一個專案的路徑，可以理解為專案名，但是一般這個名稱是可以自定義的。在SpringBoot在2.0版本之前，在yml檔案中設定專案存取路徑時通過server.context-path設定，
而在SpringBoot在2.0版本之後使用server.servlet.context-path設定專案存取路徑。

第一點後端介面能否存取

在這裡我貼出了一段程式碼，包括application.yml組態檔，後續所有的演示都基於這段程式碼與組態檔。

package com.redisson.controller;
import org.redisson.api.RedissonClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/redisson")
public class RedissonController {

    @Autowired
    RedissonClient redissonClient;

    @RequestMapping("/testRedissonClient")
    public void TestRedisson() {
        System.out.println("testRedissonClient: "+redissonClient);
    }
}

我們開始呼叫一下介面，讓404錯誤出現。（這裡使用postman測試）

情況一：server.servlet.context-path(專案存取路徑)漏寫或者名稱寫錯

情況二：類上面的@RequestMapping(“/demo”)註解裡面的值漏寫或者名稱寫錯

情況三：方法上面的@RequestMapping(“/demo”)註解裡面的值漏寫或者名稱寫錯

情況四：路徑多寫了一部分內容

總結：
埠號後面的存取路徑書寫錯誤，導致在存取後端介面時404問題的出現。像這種錯誤造成的直接後果就是請求無法進入到後端介面裡。
.
解決方案：
出現404問題了，要認真排查存取介面的地址是否正確
一般請求存取的是：專案存取路徑+類上面的@RequestMapping設定的value地址值+類上面的@RequestMapping設定的value地址值

第二點後端介面的返回值是否能夠對映到前端頁面

對於介面存取路徑書寫正確，介面能存取成功的情況下仍然會出現404問題，具體操作案例如下。

package com.redisson.controller;

import com.redisson.bean.Person;
import com.redisson.utils.Msg;
import org.redisson.api.RedissonClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/demo")
public class RedissonController {

    @Autowired
    RedissonClient redissonClient;

//    返回值是void，報404異常
    @RequestMapping("/testRedissonClient")
    public void TestRedisson() {
        System.out.println("testRedissonClient: "+redissonClient);
    }

//返回值是null，報404異常
    @RequestMapping("/testRedissonClient2_1")
    public Msg TestRedisson2_1() {
        System.out.println("testRedissonClient2_1: "+redissonClient);
        return null;
    }

//  返回值是空字元（比如 ""），報404異常
    @RequestMapping("/testRedissonClient2_2")
    public String TestRedisson2_2() {
        System.out.println("testRedissonClient2_2: "+redissonClient);
        return "";

    }

//  返回值是任意字串（比如 "success"），報404異常
    @RequestMapping("/testRedissonClient2")
    public String TestRedisson2() {
        System.out.println("testRedissonClient2: "+redissonClient);
        return "success";
    }
//返回值是雖說是null，但是在@ResponseBody註解的加持下，則不會出現404異常問題
    @RequestMapping("/testRedissonClient3")
    @ResponseBody
    public Msg TestRedisson3() {
        System.out.println("testRedissonClient3: "+redissonClient);
        return null;
    }

    //返回值是雖說是空字元，但是在@ResponseBody註解的加持下，則不會出現404異常問題
    @RequestMapping("/testRedissonClient4")
    @ResponseBody
    public String TestRedisson4() {
        System.out.println("testRedissonClient4: "+redissonClient);
        return "";
    }
    //返回值是雖說是null，但是在@ResponseBody註解的加持下，則不會出現404異常問題
    @RequestMapping("/testRedissonClient5")
    @ResponseBody
    public String TestRedisson5() {
        System.out.println("testRedissonClient5: "+redissonClient);
        return null;
    }

    //返回值是是一個json物件，但是在@ResponseBody註解的加持下，則不會出現404異常問題
    @RequestMapping("/testRedissonClient6")
    @ResponseBody
    public Msg TestRedisson6() {
        System.out.println("testRedissonClient6: "+redissonClient);
        return Msg.success("存取成功！").data("person",new Person());
    }

    //返回值是是一個json物件，但是在沒有@ResponseBody註解的加持下，則會出現404異常問題
    @RequestMapping("/testRedissonClient7")
    public Msg TestRedisson7() {
        System.out.println("testRedissonClient6: "+redissonClient);
        return Msg.success("存取成功！").data("person",new Person());
    }
}

總結：
1、新增了@ResponseBody註解的方法，在請求存取到方法裡面後，返回到前端頁面時是不會報404異常的。原因是@ResponseBody註解修飾的方法其返回值是不經過檢視解析器解析的。
.

2、埠號後面的存取路徑書寫正確，請求能夠進入到介面中，但是在返回到前端頁面時報404異常。像這種錯誤造成的直接後果就是響應結果無法在頁面展示。
.
分析：
之所以會出現這種問題是因為springBoot預設在沒有@ResponseBody註解的加持下的情況下，返回的結果是經過檢視解析器去解析並且匹配一個合適的前端頁面，然後將結果展示出來的。當我們在專案中沒有書寫相應的前端頁面時，自然檢視解析器解析的結果無法匹配到，因此報404異常.
. .
解決方案：
出現404問題了，首先排查有沒有新增@ResponseBody註解，其次要認真排查我們在專案中沒有書寫相應的前端頁面。
(1) 在controller類的方法上面或者controller類上面新增@ResponseBody註解
(2) 方法的返回值要在專案中能夠找到對應的前端頁面。