錯誤場景

使用Spring Boot的Web專案，在其 resources/static/目錄下存在login.html靜態檔案，同時還有一個處理/login請求的控制器方法(該方法會返回JSON格式的資料)。此時如果訪問localhost:8080/login.html，使用者期望返回login.html頁面，但框架卻報錯:

org.springframework.web.HttpMediaTypeNotAcceptableException: Could not find acceptable representation
    at org.springframework.web.servlet
 
.mvc.method.RequestMappingInfoHandlerMapping.handleNoMatch(RequestMappingInfoHandlerMapping.java:235) ~[spring-webmvc-4.2.4.RELEASE.jar:4.2.4.RELEASE]
    at org.springframework.web.servlet.handler.AbstractHandlerMethodMapping.lookupHandlerMethod(AbstractHandlerMethodMapping.java:382) ~[spring-webmvc-4.2
 
.4.RELEASE.jar:4.2.4.RELEASE]
    at org.springframework.web.servlet.handler.AbstractHandlerMethodMapping.getHandlerInternal(AbstractHandlerMethodMapping.java:322) ~[spring-webmvc-4.2.4.RELEASE.jar:4.2.4.RELEASE]
    at org.springframework.web.servlet.handler.AbstractHandlerMethodMapping.getHandlerInternal
 
(AbstractHandlerMethodMapping.java:60) ~[spring-webmvc-4.2.4.RELEASE.jar:4.2.4.RELEASE]
    at org.springframework.web.servlet.handler.AbstractHandlerMapping.getHandler(AbstractHandlerMapping.java:351) ~[spring-webmvc-4.2.4.RELEASE.jar:4.2.4.RELEASE]

錯誤原因

Spring Boot的MVC預設配置中使用的 ViewResolver 為 ContentNegotiatingViewResolver，該檢視解析器的功能是根據要請求的文件型別，來查詢不同的檢視以返回對應格式的文件。請求的文件型別要可以從請求頭中的Accept中獲取，也可以通過URI字尾名得到，如/login.html即為請求HTML格式的文件，這兩種方式分別對應著兩種不同的Strategy(策略)，預設為根據URI字尾名。Spring Framework Reference 17.5 節 ContentNegotiatingViewResolver中有說明：

The ContentNegotiatingViewResolver does not resolve views itself but rather delegates to other view resolvers, selecting the view that resembles the representation requested by the client. Two strategies exist for a client to request a representation from the server:
• Use a distinct URI for each resource, typically by using a different file extension in the URI. For example, the URI http://www.example.com/users/fred.pdf requests a PDF representation of the user fred, and http://www.example.com/users/fred.xml requests an XML representation.
• Use the same URI for the client to locate the resource, but set the Accept HTTP request header to list the media types that it understands. For example, an HTTP request for http:// www.example.com/users/fred with an Accept header set to application/pdf requests a PDF representation of the user fred, while http://www.example.com/users/fred with an Accept header set to text/xml requests an XML representation. This strategy is known as content negotiation.

因此，當用戶請求 /login.html 時，spring會查詢/login對應的控制器，並得到其返回的文件型別為application/json, 然後判斷它與字尾名.html文件型別是否匹配，如果不匹配，就報HttpMediaTypeNotAcceptableException了。
其實它的初衷是好的，它是想實現訪問/user.json時返回JSON資料，訪問/user.html返回HTML, 訪問/user.xml則返回XML的功能。但是在這裡我們只用Spring Boot提供RESTful介面，因此該功能就無用武之地了。

解決方案

• 防止靜態檔名跟控制器請求路由衝突。如本例中，將login.html更名為signin.html。
• 將靜態檔案URI與動態請求URI分離。如，把提供REST介面的URI都改成以/api/XXX開頭，把靜態檔案改為以/static/XXX開頭。這樣當請求/static/login.html時，spring會直接使用內建的處理靜態資源的控制器返回靜態檔案而不再去查詢使用者定義的控制器、