Springcloud踩坑記---使用feignclient遠端呼叫服務404
公司專案進行微服務改造，由之前的dubbo改用SpringCloud，微服務之間通過FeignClient進行呼叫，今天在測試的時候，eureka註冊中心有相應的服務，但feignclient就是無法調通，一直報404錯誤，排查過程如下：
一、問題：
服務提供方定義的介面如下：
/**
* 黑白名單查詢介面
*
* @author LiJunJun
* @since 2018/10/18
*/
@Component(value = "blackAndWhiteListFeignClient")
@FeignClient(value = "pear-cache-service", path = "v1/cache/limitlist")
public interface IBlackAndWhiteListFeignClient {
/**
* 獲取黑白名單手機號分組編號
*
* @param trace 請求流水
* @param phoneNum 電話號碼
* @return 電話號碼所在分組
*/
@RequestMapping(value = "/blackAndWhiteList", method = RequestMethod.POST, produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
ResultData<String> blackAndWhiteList(@RequestHeader(name = "Trace") String trace, @RequestParam("phoneNum") String phoneNum);
}
介面實現類如下：
/**
* 黑白名單controller
*
* @author LiJunJun
* @since 2018/10/18
*/
@ProtectedLdApi
@RestController
@RequestMapping(value = "v1/cache/limitlist")
@Api(value = "黑白名單快取", description = "黑白名單快取相關介面")
public class BlacklAndWhiteListController extends AbstractController implements IBlackAndWhiteListFeignClient {
/**
* 日誌記錄器
*/
private final static Log LOGGER = new Log(BlacklAndWhiteListController.class);
/**
* 注入tedis
*/
@Autowired
private JedisSentinelPoolExt jedisSentinelPool;
/**
* 獲取黑白名單手機號分組編號
*
* @param trace 請求流水
* @param phoneNum 電話號碼
* @return 電話號碼所在分組
*/
@Override
@ApiOperation(value = "獲取黑白名單手機號分組編號", notes = "根據電話號碼從快取中獲取黑白名單分組")
@RequestMapping(value = "/blackAndWhiteList", method = RequestMethod.POST, consumes = MediaType.APPLICATION_JSON_UTF8_VALUE, produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
public ResultData<String> blackAndWhiteList(@RequestHeader(name = "Trace") String trace, @RequestParam("phoneNum") String phoneNum) {
do something...
}
}
呼叫方如下：
public class MessageListController {
private static final Log LOGGER = new Log(MessageListController.class);
@Autowired
private IBlackAndWhiteListFeignClient blackAndWhiteListFeignClient;
@RequestMapping(value = "/testBlackAndWhiteList", method = RequestMethod.POST, produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
public ResultData<String> testBlackAndWhiteList() {
LOGGER.info("開始呼叫快取介面");
ResultData<String> res = blackAndWhiteListFeignClient.blackAndWhiteList("asdqwezxxc", "B18037903086");
LOGGER.info("呼叫結果：" + res.getResultData());
return res;
}
呼叫結果：
華麗麗的404了，很頭疼，經過各種度娘，發現導致這個問題有兩個原因，以下是解決方法：
二、問題分析
經過百度，說將SpringBoot配置檔案裡面 server.servlet.context-path 註釋掉即可，抱著試一哈的態度，註釋了，重啟，呼叫，結果驚喜的發現，依舊報錯了，但仔細一看，錯誤程式碼已經不是404，變成了415，這就相當於調通了，但是，Content-Type的型別不對，於是，返回去看程式碼（此時已經肯定，今天能把feignclient介面調通），
仔細一看發現，介面上定義的@RequestMapping中，只定義了 produces = MediaType.APPLICATION_JSON_UTF8_VALUE， 而實現類中，@RequestMapping定義了consumes、produces均為 "application/json;charset=UTF-8"
我們知道，consumes定義了方法接受的Http的請求型別，produces則定義了Http請求返回的型別；
然後我們說下FeignClient，它的底層實現，就是根據定義的FeignClient介面，來組裝Http請求進行遠端呼叫，而Http預設的Content-type是x-www-form-urlencoded型別化的，到這兒，問題就呼之欲出了：
再來回顧上面我們定義的介面，並沒有指定請求型別（consumes），那麼FeignClient組裝的Http請求的型別就是預設的x-www-form-urlencoded型別，但我們的實現類上，卻定義了consumes=MediaType.APPLICATION_JSON_UTF8_VALUE，也就是說，僅接受json型別的請求，這就是為什麼415的原因了；
三、解決方法
知道了問題的原因，解決起來就很簡單了，我們可以在FeignClient的介面定義上，指定consumes，這樣，FeignClient在組裝Http請求的時候，就會在header裡面設定請求型別為application/json，這樣，問題就完美解決；
再來看呼叫結果：
完美返回！！！
四、總結
feignclient介面定義是一個模板化的，其組裝的Http請求完全按照你定義的介面去組裝，如你在引數中，用@RequestHeader去接收一個引數，其組裝請求時，就會將你傳入的引數放至Header中，你指定的consumes為json，其組裝的請求Content-Type就是 application/json型別的，完全不需要呼叫方感知，就像呼叫普通方法一樣，不得不說，很強大，只要生成的Http請求正確，服務提供方提供的Rest介面能和FeignClient組裝的Http請求，就能夠完成遠端呼叫。
五、遺留問題
為什麼需要將服務提供方的 server.servlet.context-path 去掉才能實現呼叫，今天暫時沒有研究，但一定有解決方案，SpringCloud不會這麼low的，解決方案研究出來會補上。