Grails 5应用war包无法找到GSP文件，但grails run-app运行正常

问题概述 #

Grails 3.x应用使用grails run-app运行完全正常，但通过以下命令构建war包并以内嵌服务器运行时，自定义GSP视图无法加载，抛出视图解析错误：

./gradlew assemble
java -Dgrails.env=dev -jar build/libs/rideshare-services-3.0.war

错误日志：

Servlet.service() for servlet [grailsDispatcherServlet] in context with path [] threw exception [Could not resolve view with name '/index' in servlet with name 'grailsDispatcherServlet'] with root cause
javax.servlet.ServletException: Could not resolve view with name '/index' in servlet with name 'grailsDispatcherServlet'
    at org.springframework.web.servlet.DispatcherServlet.render(DispatcherServlet.java:1384)
    <snip>

已知情况：

• Spring Security的/login/auth表单视图、静态资源、actuator端点均可正常访问
• URL映射已验证可正确解析到控制器动作，控制器代码能执行
• 解压war包确认GSP已编译，views.properties存在正确映射，编译后的GSP类和源文件都在对应路径

解决方案 #

1. 替换war包构建命令 #

使用Grails原生的grails war命令替代./gradlew assemble：

grails war
java -Dgrails.env=dev -jar build/libs/rideshare-services-3.0.war

Grails的war任务会专门处理GSP编译、视图映射生成等Grails特定的打包逻辑，而gradlew assemble可能缺少部分Grails专属的打包步骤，导致视图解析路径异常。

2. 检查视图解析器配置 #

在application.groovy或application.yml中确认是否存在自定义视图解析器配置，避免覆盖Grails默认的GSP视图解析器：

• 移除任何手动添加的org.springframework.web.servlet.view.InternalResourceViewResolver或自定义ViewResolver bean
• 确保grails.views.gsp.prefix和grails.views.gsp.suffix配置未被错误修改，默认配置应为：

grails.views.gsp.prefix = '/'
grails.views.gsp.suffix = '.gsp'

3. 禁用开发模式下的GSP重载 #

dev环境下默认开启的GSP重载特性可能在war包运行时导致视图加载异常，在application.yml的dev环境配置中添加：

grails:
    gsp:
        enable.reload: false

war包运行时无需实时重载GSP，禁用该特性可让应用使用编译后的GSP类而非尝试加载源文件。

4. 验证编译后的GSP类加载路径 #

确认war包中WEB-INF/classes下的编译GSP类（以gsp_开头的class文件）与views.properties中的映射完全匹配：

• 检查views.properties中的视图路径是否与实际GSP类的包结构一致，例如映射/WEB-INF/grails-app/views/member/index.gsp=gsp_rideshare_services_memberindex_gsp对应的类应为gsp_rideshare_services_memberindex_gsp.class
• 确保没有大小写错误（部分操作系统对路径大小写敏感）

5. 清理并重新构建 #

执行以下命令清理旧构建产物后重新打包：

./gradlew clean
grails war

旧的编译缓存可能导致视图映射或类文件异常，清理后重新构建可排除此类问题。

内容的提问来源于stack exchange，提问作者Scott McIntosh