建立Confluence与JIRA任务关联：实现无缝协作

Confluence 管文档，JIRA 管任务，两边各用各的，就会出现需求改了三遍、任务单还停在第一版的情况。把两者关联起来后，文档里直接引用任务，状态变化一眼可见。这篇记录两件事：应用程序链接怎么配，页面里怎么挂 JIRA 问题。

关联之后解决什么

在 Confluence 页面里，可以通过插入 JIRA 任务链接或使用 “JIRA Issues” 宏来关联任务，项目计划、需求文档、设计规范都能对应到具体的 JIRA 单。团队成员不用在两个系统之间来回翻找信息，文档与任务保持一致、可追溯，信息孤岛和重复劳动少了，项目进度也更透明。

第一步：配置应用程序链接

在 Confluence 管理控制台的应用设置里打开应用程序链接，把 JIRA 添加为应用，按向导完成双向配置。

注：这里填写的应用链接地址就是 JIRA 的访问地址。环境里是 IP 就填 IP，是域名就填域名，保持与浏览器实际访问的一致，否则宏会加载失败。配置完成后，两边应用列表里都能看到这条链接，状态为已授权。

第二步：在文章里关联 JIRA 项目

页面编辑状态插入 “JIRA Issues” 宏，选择对应的 JIRA 项目，可以直接输入问题编号，也可以按状态、经办人等条件过滤。页面里会显示任务标题、状态和处理人，点击可跳转 JIRA 详情。

注意事项

1. 两台服务必须网络互通，中间有负载均衡或代理时，应用链接要用客户端实际可达的地址。2. 宏渲染的内容受 JIRA 权限控制，读者在 JIRA 里没有对应项目的浏览权限，页面就是空的，最好统一两边账号体系。3. 项目归档或改名后，记得回头更新页面里宏的过滤条件，否则会显示查无结果。