Orbeon Forms升级：需迁移原WEB-INF下哪些配置文件？

Orbeon Forms不同版本的配置结构、参数存在差异，直接替换旧版配置文件极易引发兼容性问题，以下是需按需迁移的核心文件/目录：

1. 核心属性与权限配置 #

• WEB-INF/resources/config/properties-local.xml：仅迁移自定义的全局属性（如数据库连接、表单存储路径、第三方服务配置等），需对比新版默认properties.xml，只合并自定义项，不要直接覆盖。
• WEB-INF/resources/config/form-builder-permissions.xml：可完整迁移，但需确认新版是否新增权限节点，按需补充调整。
• WEB-INF/resources/config/form-runner-permissions.xml：若旧版有自定义表单运行器权限规则，需迁移并适配新版格式。

2. Web应用配置（web.xml） #

绝对不能直接替换新版web.xml，需对比新旧版本：

• 迁移自定义的上下文参数（如oxf.xforms.renderer、自定义初始化参数）
• 迁移新增的Servlet映射、过滤器配置（如自定义安全过滤器）
• 保留新版默认的Servlet、过滤器节点，仅合并自定义扩展内容

3. 日志配置 #

• 若新版仍使用Log4j：迁移WEB-INF/resources/config/log4j.xml，但需检查日志输出路径、级别配置是否适配新版目录结构
• 若新版切换为Logback：需将旧版Log4j配置转换为logback.xml格式再迁移

4. 自定义扩展与资源 #

• WEB-INF/lib：迁移所有自定义依赖jar包（如数据库驱动、自定义Orbeon插件、第三方工具包）
• WEB-INF/resources/apps：完整迁移自定义表单应用（含自己开发的表单、专属CSS/JS资源）
• WEB-INF/resources/custom：迁移全局自定义样式、脚本、本地化语言包等资源

5. 其他可选配置 #

• WEB-INF/resources/config/oxf-web.xml：若旧版有自定义请求处理、文件上传限制等配置，对比新版合并自定义项
• WEB-INF/resources/config/*.properties：自定义本地化属性文件（如自定义提示文本）需迁移

关键注意事项 #

直接替换web.xml是引发报错的常见原因，新版web.xml包含Orbeon运行必需的Servlet、过滤器配置，覆盖后会导致核心组件无法加载。迁移时务必采用合并配置而非全量替换的方式，同时参考对应版本的官方升级文档，确认废弃/新增的配置项。

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