OpenProject 7.2.2 维护版发布解读：6 项缺陷修复、界面优化与 CentOS 7 升级注意事项

OpenProject 7.2.2 维护版发布解读：6 项缺陷修复、界面优化与 CentOS 7 升级注意事项

【免费下载链接】openprojectOpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub项目地址: https://gitcode.com/GitHub_Trending/op/openproject

本指南基于 OpenProject 官方 7.2.2 版本发布说明，逐一解析该维护版本修复的 6 个核心 Bug 与 2 项界面改进，并结合当前仓库源码说明其涉及的实现模块（工作包表格渲染、Textile/Markdown 文本格式化、附件挂载、浏览器兼容性等），同时给出 CentOS 7 用户在升级 7.2 及以上版本时必须执行的软件源切换操作，帮助运维与开发人员理解补丁动机、验证修复效果并安全完成升级。

版本概览

OpenProject 7.2.2 发布于2017 年 9 月 4 日（见 7.2.2 发布说明 的 front-matterrelease_date字段），属于 7.2 系列的一个维护版本（patch release）。它不引入新功能，核心目标是在最短周期内收敛上一版本遗留的回归问题，共包含：

• 6 项缺陷修复（Bug fixes）：覆盖工作包表格交互、文本渲染、附件管理、表单校验与浏览器兼容性；
• 2 项视觉改进（Visual changes）：优化表格内编辑体验与表单配置页图标一致性；
• 1 项部署提示（CentOS 7 软件源变更）：涉及 7.2+ 的包升级路径，需要运维人员特别关注。

按照官方发布流程，每个修复项都关联了 OpenProject 社区工作包（work package）编号，可用于在社区实例中回溯问题详情与讨论线程。

缺陷修复详解（6 项）

1. 使用时间轴后工作包表格与时间轴视图的行高亮失效

社区编号：#26168

现象：在打开了甘特时间轴（timeline）的工作包表格中，一旦与时间轴交互（如滚动、切换显示区间），表格行和时间轴行的行高亮（row highlighting）会停止生效。

源码佐证：从当前仓库的前端实现可以清晰看到行高亮与时间轴渲染是两条串行且相互依赖的渲染通道。在 主渲染通道 primary-render-pass.ts 的render()中，执行顺序是：

primary pass（表格主体行渲染） → highlighting.render() // 行高亮渲染通道 → relations / childRelations // 关系行渲染 → dragDropHandle // 拖拽手柄渲染 → timeline.render() // 时间轴渲染通道

行高亮由独立的 HighlightingRenderPass 负责，它会读取当前查询的“高亮模式”（wpTableHighlighting.current.mode），对每个自然工作包行追加对应属性值（如类型、优先级、状态）的背景 class。而时间轴渲染会在主渲染之后修改行结构，7.2.2 之前的实现中二者交互后高亮状态未能正确同步，导致高亮“消失”。该补丁修复了表格与时间轴共用行数据时的高亮同步问题。

验证建议：升级到 7.2.2 后，打开任意带高亮配置（工作包表格右上角“配置”中的高亮选项）的表格并切换时间轴显示，确认行背景色在交互后仍然保持。

2. Textile 解析错误导致工作包描述不再渲染

社区编号：#26159

现象：当工作包描述中包含特定格式的 Textile 语法时，解析器报错，导致描述字段完全无法渲染。

背景说明：OpenProject 的文本格式化（text formatting）体系继承自 Redmine 生态。当前仓库中，文本渲染由lib/open_project/text_formatting模块实现，其中包含一系列 matcher（匹配器），例如 wiki_links_matcher.rb 负责解析[[wiki链接]]语法——它通过正则/!?(\[\[([^\]\n|]+)(\|([^\]\n|]+))?\]\])/识别 wiki 链接、锚点（#）与转义写法（![[...]]）。7.2.2 修复的即是在这些 matcher 组合解析特定 Textile 输入时抛出的异常路径，避免整个描述字段渲染被单点错误中断。

补充说明：在后续版本中，OpenProject 已全面切换到 CommonMark（Markdown），当前源码中的 markdown_filter.rb 使用 CommonMarker 完成 Markdown→HTML 转换，并显式启用了table、strikethrough等扩展。这意味着 7.2.2 时代所修复的 Textile 渲染问题，在现代版本中已随格式化引擎的换代而不再适用，但它作为历史版本行为，仍对从 7.2 时代升级的老用户具有参考意义。

3. 新建工作包表单中待上传附件无法移除

社区编号：#26117

现象：在“新建工作包”表单中，用户一旦添加了附件（处于 pending / 待上传状态），就无法再将其从表单中移除，导致误选文件后无法撤销。

影响范围：该问题只影响尚未保存的新建表单（新建工作包与编辑表单场景分离），已持久化工作包的附件移除功能不受影响。7.2.2 使 pending 附件支持在表单提交前被删除，符合直觉的“取消已选文件”交互。

4. 新闻表单摘要字段宽度提示误导

社区编号：#26113

现象：新闻（News）条目表单中的“摘要（Summary）”输入框宽度，暗示用户可以输入超过 256 个字符，但实际后端校验会拒绝超长内容。

源码佐证：当前仓库的 News 模型 中明确存在约束：

validates :summary, length: { maximum: 255 }

也就是说，摘要字段的上限是255 个字符。7.2.2 修复了表单控件宽度与后端校验不一致的问题，使输入框的视觉提示与实际校验规则一致，避免用户在超限输入后才发现提交失败。

5. Firefox 中点击工作包描述里的外部链接报错

社区编号：#26163

现象：在 Firefox 中点击工作包描述中的外部链接，跳转本身可以正常完成，但同时会弹出一条错误通知（error notification），造成“链接可用但界面报错”的割裂体验。

定位：该问题属于前端事件处理与浏览器兼容性范畴，与工作包描述的富文本渲染以及 OpenProject 的 flash/通知机制相关。修复后，外部链接点击不再产生误报的错误提示。

6. 未转译的 ES6 代码导致旧浏览器白屏而非“浏览器不受支持”提示

社区编号：#26153

现象：由于打包产物中存在未经转译（non-transpiled）的 ES6 语法，在不支持 ES6 的旧浏览器中，前端直接白屏（什么都不渲染），而不是展示 OpenProject 预期的“此浏览器不受支持”友好提示。

影响：这个问题直接影响“优雅降级”策略——正常情况下，OpenProject 会为不支持的浏览器渲染明确提示页，而 7.2.2 之前该提示机制本身被 ES6 语法错误阻断，用户只会看到一个空白页面，难以判断问题原因。该修复确保构建产物中不再泄漏未转译语法，使浏览器检测逻辑能够按预期工作。

界面改进（Visual changes）

7. 表格内联编辑不再大幅改变列宽

社区编号：#26100

工作包表格支持在单元格内直接编辑属性（inline editing）。此前，进入编辑状态后列宽会发生明显跳动，破坏整体布局稳定性。7.2.2 优化了编辑状态下的列宽计算，使“编辑中”与“展示态”之间的视觉切换更平滑。这与现代版本中快速表格（wp-fast-table）的渲染架构一脉相承——单元格渲染与行渲染分离，编辑态仅替换单元格内容而不重排整列。

8. 表单配置页中普通字段与自定义字段图标统一

社区编号：#26129

在“表单配置（form configuration）”标签页中，普通字段属性与自定义字段属性的图标此前不一致。7.2.2 统一了两类字段的图标呈现，避免用户在配置表单布局时产生混淆。该改动属于纯视觉层面，不影响字段的存储与校验逻辑。

CentOS 7 用户升级必读：软件源切换

关联社区编号：#26144

发布说明专门用一节提醒 CentOS 7 用户：

如果你正在使用 CentOS 7，并计划升级到 OpenProject 7.2 或更高版本，请务必同时按照“下载与安装”页面更新你的软件包源（package source）。

原因：OpenProject 从 7.2 起调整了 CentOS 7 的 RPM 软件源地址。如果只执行yum update openproject而不同步更新 yum 源配置，升级过程会失败或拉取到错误仓库的包。

推荐的升级路径（以官方“下载与安装”页面的指引为准）：

1. 先按官方页面提供的新源配置替换/etc/yum.repos.d/下的 OpenProject 仓库文件（源地址变更细节见社区编号 #26144 与相关论坛讨论）；
2. 再执行系统更新：sudo yum update openproject；
3. 最后运行 OpenProject 的配置向导（openproject reconfigure）完成数据库迁移与配置刷新。

注意：当前仓库的安装运维文档目录 docs/installation-and-operations 仅保留通用安装说明；7.2 时代 CentOS 7 的专属软件源信息已随版本演进更新，请以当时官方“下载与安装”页面为准。该注意事项适用于所有计划从 7.1 及更早版本跨级升级到 7.2+ 的 CentOS 7 部署。

致谢与更多信息

官方发布说明特别感谢了社区成员Frank Schmid、Markus Hillenbrand 和 Marc Vollmer对本次缺陷报告的贡献，体现了 OpenProject 社区驱动的质量保障流程。

如需进一步了解 7.2.2 的完整变更清单，可查阅：

• 官方Changelog v7.2.2（对应社区版本 846）；
• 仓库根目录的 CHANGELOG.md，其中记录了各版本的变更历史；
• 本仓库 docs/release-notes 目录下的其他版本发布说明，可用于横向对比 7.2 系列各维护版本的问题收敛情况。

升级建议小结

作为 7.2 系列的收尾性维护版本，7.2.2 虽然改动幅度不大，却精准覆盖了表格交互、文本渲染、附件管理、表单校验、浏览器兼容与部署升级六个维度，是 7.2 系列值得部署的稳定补丁版本。

【免费下载链接】openprojectOpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub项目地址: https://gitcode.com/GitHub_Trending/op/openproject