Jira看板自定义卡片字段设置保存后不显示怎么办？

Des.晓萌提问于 2026-02-03 16:47:33 阅读 45

工具

在Jira看板里想自定义显示剩余时间字段，按照官方教程进入「卡片布局」设置后勾选了自定义字段，保存重启浏览器还是没显示出来，是什么原因啊？

我尝试过：

检查字段权限设置
切换不同浏览器测试
重新索引Jira实例

前端用Vue渲染任务卡片时，数据明明能拿到：


<template>
  <div class="jira-card" v-for="task in tasks" :key="task.id">
    <h3>{{ task.summary }}</h3>
    <p v-if="task.remainingEstimate">
      剩余时间：<strong>{{ task.remainingEstimate }}</strong>
    </p>
    <!-- 这里应该显示自定义字段但实际不渲染 -->
  </div>
</template>

难道跟Jira的字段筛选器设置有关？或者需要重启服务才能生效？

Jira 敏捷开发

我来解答赞 7 收藏

反馈

1 条解答

Des.书錦 Lv1

你这个问题我也遇到过几次，Jira的字段显示问题确实容易让人抓狂。按照官方文档和我实际操作的经验来看，**保存后不显示**的问题一般有以下几个原因：

1. **字段作用域没配对**：确认你的自定义字段所在的字段配置（Field Configuration）是否被当前项目的看板视图所使用。有时候字段虽然启用了，但被字段配置屏蔽了。

2. **卡片布局设置没生效**：虽然你已经勾选了自定义字段，但Jira的看板卡片布局有时候会缓存旧配置。可以尝试切换视图模式（比如从看板切换到列表，再切回来）强制刷新。

3. **字段值为空不显示**：Jira默认不会显示空值字段。你可以检查一下是否你的任务中该字段没有设置值，或者设置了但格式不合法。比如剩余时间字段如果是自定义字段，可能格式不对，导致前端不渲染。

4. **Vue模板的字段名不匹配**：你提到前端用的是Vue渲染，说明可能是自定义插件或扩展。检查 task.remainingEstimate 是否真的绑定了你的自定义字段数据。如果是自定义字段，Jira后端字段ID一般是 customfield_12345 这种形式，前端要确认是否真的正确映射到了 remainingEstimate。建议用 console.log(task) 打印看看有没有这个字段。

5. **权限和上下文配置问题**：再检查一下字段的上下文（Context）设置，确认是否适用于当前项目、问题类型和屏幕方案。如果字段的上下文不包含当前看板的问题类型，就不会显示。

6. **浏览器缓存或脚本冲突**：虽然你换了浏览器，但某些脚本可能会污染页面结构。可以尝试清除浏览器插件影响（如广告拦截、脚本管理器），或者用隐身模式测试。

**建议操作顺序：**

- 在「卡片布局」里重新保存一次设置
- 清除浏览器缓存并使用隐身模式打开
- 检查字段上下文和权限配置
- 打印 Vue 数据确认字段存在
- 最后才是重启 Jira 服务（一般不需要）

我们一般不会轻易重启Jira，除非改了插件或做了系统级变更。这个问题大概率是配置没生效或字段名映射错了，优先排查前端数据结构和字段作用域。

2026-02-03 17:00