WildFly 31 VFS部署目录contents下缺失应用JAR文件问题

问题现象 #

• WildFly 30.0.1.Final 启动时，应用库会完整复制到路径：%wildfly-31.0.1.Final%\standalone\tmp\vfs\deployment\deployment90110bdf73e52ecf\contact.jar-c26da1d272c45e0d
• 升级至 31.0.1.Final 后，仅在路径：%wildfly-31.0.1.Final%\standalone\tmp\vfs\deployment\deployment90110bdf73e52ecf\contact.jar-6fa846a7d1d310c5\contents 生成空文件夹
• 环境：OpenJDK 17.0.2，服务器日志无明显错误信息

可能原因 #

• VFS 懒加载优化：WildFly 31 调整了 VFS 文件处理逻辑，改为仅在实际访问 Jar 内容（如读取类、资源文件）时才解压/复制文件，而非启动阶段预加载，属于性能优化范畴。
• 部署配置变更：standalone.xml/domain.xml 中的部署扫描器（deployment-scanner）属性或 VFS 相关系统属性存在版本间配置差异。
• Jar 文件隐性问题：contact.jar 可能存在完整性问题，WildFly 31 对 Jar 校验逻辑更严格，导致未正常解析内容。
• 目录权限不足：VFS 临时目录的读写权限不足，导致无法写入 Jar 内容（日志未捕获静默权限错误）。

排查与解决步骤 #

1. 验证懒加载逻辑
   触发应用对 Jar 内资源的访问（如调用依赖接口、读取配置文件），之后检查 VFS 目录是否已填充内容。

2. 对比部署配置差异

   • 打开 standalone/configuration/standalone.xml，查找 <deployment-scanner> 节点，对比 WildFly 30 与 31 的配置，重点关注 scan-interval、deployment-timeout 等属性。
   • 检查启动脚本（如 standalone.bat/standalone.sh）中是否添加了 VFS 相关系统属性（如 jboss.vfs.cache），确认是否存在配置冲突。

3. 校验 Jar 文件完整性

   • 执行命令 jar tf contact.jar，列出 Jar 内所有文件，确认内容完整。
   • 手动解压 contact.jar 到临时目录，验证是否能正常提取所有文件。

4. 检查目录权限与清理缓存

   • 确保 WildFly 运行用户对 %wildfly-31.0.1.Final%\standalone\tmp 目录及其子目录拥有完全读写权限。
   • 删除 standalone/tmp/vfs 下的所有缓存文件，重新启动服务器测试。

5. 查看 VFS 详细日志

   • 在 standalone.xml 的日志子系统中添加 DEBUG 级别的 VFS 日志配置：

     <subsystem xmlns="urn:jboss:domain:logging:8.0">
         <!-- 其他日志配置 -->
         <logger category="org.jboss.vfs">
             <level name="DEBUG"/>
         </logger>
     </subsystem>
     

   • 重启服务器后，查看 VFS 相关日志，排查是否存在隐性警告或异常。

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