install4j更新时lib目录文件残留的原因排查求助

核心原因 #

1. install4j更新默认是增量逻辑：常规更新只会替换与安装包内文件名完全匹配的文件、新增不存在的文件，但不会主动删除安装包未包含的旧文件——比如带不同版本号的application-1.0.0.25194.jar这类文件名唯一的文件，会被当成无关文件保留。
2. 更新流程未纳入卸载步骤：从更新日志能看到，整个过程没执行Execute previous uninstaller或Uninstall files动作，说明你的更新构建里没把这些卸载步骤加入流程，或者步骤的触发条件未满足（比如没针对sys.isUpdateInstallation变量设置触发规则）。
3. 文件识别规则限制：旧版本的application和commons JAR因为版本号不同，被视为全新文件名，不属于install4j默认的"需要替换"范畴，因此不会被自动删除。

解决办法 #

• 启用完整更新模式：在install4j项目的「更新器」配置中，选择「执行完整卸载然后重新安装」选项。更新时会先执行和常规卸载完全一致的清理流程，再安装新版本，彻底避免遗留旧依赖。
• 给更新流程添加卸载动作：
  1. 向更新序列中添加Uninstall files动作，指定目标目录为C:\Program Files (x86)\App\lib，并设置触发条件为sys.isUpdateInstallation == true。
  2. 或者添加Execute previous uninstaller动作，确保更新时先调用旧版本卸载程序清理文件。
• 用脚本过滤清理旧文件：在Install Files动作中添加「文件过滤器脚本」，编写逻辑删除lib目录中不属于当前安装包的文件，示例脚本：

  // 保留当前安装包内的文件，删除其他所有jar
  def currentFiles = context.getInstallationFileNames()
  return !currentFiles.contains(file.getName()) && file.getName().endsWith(".jar")
  

• 统一依赖文件名（可选）：如果业务允许，将带版本号的依赖文件名改为无版本号（比如application.jar），这样更新时install4j会直接替换旧文件，无需额外清理。

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