同一Jira Cloud站点多Forge应用冲突问题求助
问题背景
我正在为Jira Cloud开发两款独立的内部Forge应用,均部署在同一个Jira Cloud站点(*.atlassian.net),使用不同的Forge环境和独立应用项目。
两款应用的核心特征:
- 各自拥有独立的
app.id - 从不同本地目录部署
- 使用唯一的函数键和资源键
- 安装在独立的Forge环境(如audit-dev、sandbox等)
- 未使用
forge tunnel
异常现象
安装第二个应用后,第一个应用立即无法正常工作:
- 第一个应用的iframe加载失败
- 浏览器控制台报错:
Uncaught Error while sending bridge message: Window did not load after 10000ms
经测试确认:无论安装顺序如何,第二个安装的应用都会导致第一个应用失效。
已尝试的排查动作
- 使用不同控制台部署应用
- 验证
manifest.yml无重复键值 - 从独立本地文件夹部署
- 重命名资源路径和函数键
- 直接使用
forge deploy和forge install命令,不依赖tunnel
问题
- 同一Jira站点的非生产环境部署多应用时,此现象是否正常?
- 能否不将任一应用放入生产环境,同时运行多个Forge应用?
- 如何在同一站点安全地进行多应用的内部开发与测试?
解答
1. 该现象完全不正常
Forge原生支持同一Jira站点同时运行多个独立应用,无论是否为生产环境。你遇到的iframe加载超时问题属于异常情况,大概率是应用间的资源冲突、配置重复或环境部署环节的疏漏导致,并非平台的正常限制。
2. 完全可以在非生产环境同时运行多个Forge应用
Atlassian没有限制非生产环境的应用数量,只要每个应用的核心配置(app.id、函数键、资源键等)完全独立,就能够正常共存。当前问题是配置或部署环节的异常,而非平台的硬性限制。
3. 多应用并行开发测试的实操方案
- 严格隔离配置键值:确保每个应用的
manifest.yml中,所有key字段(包括函数、资源、模块)全局唯一,哪怕不同环境的应用也不要复用相同键名。 - 检查权限范围:避免两个应用请求重叠且冲突的权限,比如同时申请对同一Jira模块的独占访问权限。
- 绑定专属环境部署:部署时明确指定应用所属环境(
forge deploy --environment <env-name>),安装时也绑定对应环境(forge install --environment <env-name>),确保应用的部署资源完全隔离。 - 清理站点残留后重新部署:先卸载站点内所有相关测试应用,清理残留配置,再逐个部署安装,每完成一个就验证其运行状态,确认正常后再进行下一个。
- 检查iframe加载逻辑:确认第一个应用的iframe没有硬编码依赖特定环境变量或资源路径,避免被第二个应用的部署覆盖相关资源。
内容的提问来源于stack exchange,提问作者Donald Shannon
相关产品推荐
相关产品推荐

