如何确认遗留Grails 2.4.0项目WAR包中是否包含指定JS文件？

我来帮你梳理下Grails 2.4.0项目里排查JS文件未打包进WAR的几个关键方向，都是这个版本常见的排查点：

1. 先直接验证WAR包内容（最直观的方式） #

不用绕弯子，先确认文件到底在不在WAR里：

• 用命令行执行 jar tf your-app-name.war，这个命令会列出WAR包内的所有文件路径。
• 直接在输出里搜索你的目标JS文件名，看看它是否出现在web-app/js/或其他静态资源目录下。如果完全搜不到，那确实没被打包；如果能找到，那可能是部署或前端加载的问题，但结合你说run-app也没加载的情况，大概率是打包环节出了问题。

2. 重点检查Resources插件的配置（Grails 2.x的核心） #

Grails 2.4.0默认启用Resources插件，静态资源的打包逻辑基本由它控制，不一定在BuildConfig里直接写路径，要查这几个地方：

• 打开grails-app/conf/Config.groovy，搜索grails.resources相关配置，比如grails.resources.excludes或grails.resources.includes，看看有没有把你的JS文件加入了排除列表。
• 检查项目里是否有grails-app/conf/Resources.groovy文件（很多项目会用这个专门配置Resources插件）：
  • 看看里面的modules定义，你的JS有没有被包含到某个资源模块里？如果你的JS没被任何模块引用，且项目是通过模块加载资源的，打包时可能会被忽略。
  • Resources插件默认会打包web-app/js/下的所有文件，但如果有自定义的排除规则，就会跳过指定文件。

3. 排查BuildConfig.groovy里的WAR打包自定义规则 #

虽然你没找到源目录配置，但BuildConfig里可能有grails.war.resources闭包，这个是用来自定义WAR打包过程的，比如有没有写了删除/排除文件的逻辑：

grails.war.resources = { stagingDir ->
    // 比如这种配置会在打包时删除指定JS文件
    delete(file: "${stagingDir}/js/your-missing-file.js")
}

如果有类似代码，就会导致目标JS被从最终WAR里移除。

4. 确认JS文件的存放位置是否符合Grails 2.x的规范 #

Grails 2.x默认只会自动打包web-app/目录下的静态资源（比如web-app/js/、web-app/css/），如果你的JS放在了非常规目录：

• 比如src/main/webapp/（Maven风格目录）：Grails 2.4.0默认不会自动打包这个目录，除非你在BuildConfig里配置grails.war.includes来包含该目录。
• 比如grails-app/assets/：这个是Grails 3.x的默认资源目录，但Grails 2.x默认没启用Assets插件，所以这个目录的文件不会被打包。

5. 清理构建缓存再试 #

有时候IDE或Grails的构建缓存会导致异常，试试以下步骤：

• 执行 grails clean 清理构建缓存，然后再执行 grails war 重新打包。
• 手动删除项目根目录下的target/文件夹，这个目录里的临时文件可能干扰打包结果。

6. 检查自定义构建脚本 #

Grails底层基于Ant构建，有些项目会在grails-app/scripts/目录下自定义构建脚本，比如_Events.groovy或War.groovy，这些脚本可能修改了WAR打包规则，排除了你的JS文件。去这个目录看看有没有相关文件，检查里面是否有排除目标文件的逻辑。

内容的提问来源于stack exchange，提问作者Sandeepan Nath