SpringMVC或SpringBoot中“Circular view path“异常的原因及解决办法

现象

报错：Circular view path [home]: would dispatch back to the current handler URL [/home] again. Check your ViewResolver setup!

根本原因

在SpringMVC中有如下代码：

if (path.startsWith("/") ? uri.equals(path) : uri.equals(StringUtils.applyRelativePath(uri, path))) {
    throw new ServletException("Circular view path [" + path + "]: would dispatch back " +
                        "to the current handler URL [" + uri + "] again. Check your ViewResolver setup! " +
                        "(Hint: This may be the result of an unspecified view, due to default view name generation.)");
}

这段代码的含义是如果你的视图名字和你的请求路径的名字相同，就回抛出"Circular view path"异常。
也就是说如果你的映射是@GETMapping("/goods")，同时你在该方法换回的ModelView对象的名字也为good的话，就会抛出该异常。

现实情况

在类的开头忘记添加@RestController注解，此时该Controller类中会返回ModelView对象；若添加了该注解，则会将返回值以某种特定形式写入response的body中，同时ModelView对象为null。如果你忘记添加该注解，同时返回了一个对象或字符串，SpringMVC会将其默认封装到一个ModelView对象中，并将你的请求映射地址作为该对象的默认对象名，从而产生异常。默认视图名详情参看Spring Boot 中这个默认视图名有点意思，看懂直呼内行内行！