车载测试中如何通过 Jira 平台提交 Bug：操作步骤与关键要点

1. 引言

在车载测试过程中，发现 Bug 只是第一步，如何规范、高效地通过 Jira 平台提交 Bug，直接影响到开发团队定位问题、修复缺陷的效率。本文将从 Jira 提交 Bug 的完整操作步骤出发，梳理每个环节的关键要点，帮助测试人员提交高质量、可追溯的缺陷单。

2. 提交 Bug 前的准备工作

在打开 Jira 页面之前，建议先完成以下准备工作，避免提交过程中反复修改：

• 确认 Bug 可复现：多次复现问题，记录稳定的复现步骤，避免提交偶发性、无法复现的问题。
• 收集现场信息：包括车辆型号、控制器版本、软件版本、硬件版本、测试环境、测试时间等。
• 准备日志与截图：抓取 CAN 日志、以太网日志、串口日志，截取故障画面或录制视频。
• 确认所属模块：明确 Bug 属于哪个子系统，如智能座舱、ADAS、车身控制、动力系统等，便于选择正确的组件和经办人。

3. Jira 提交 Bug 的操作步骤

3.1 进入项目并创建问题

登录 Jira 后，进入对应的车载测试项目，点击页面顶部的「创建」按钮，进入问题创建页面。

3.2 选择问题类型

在问题类型下拉框中，选择「Bug」或「缺陷」。部分车载项目会自定义问题类型，如「实车缺陷」「台架缺陷」「路测缺陷」，请按项目规范选择对应类型。

3.3 填写必填字段

不同项目的字段配置略有差异，但以下字段通常为必填项：

字段名称	填写说明
摘要（Summary）	用一句话概括问题，建议采用「模块 + 现象 + 条件」的格式，例如「智能座舱在高温环境下中控屏黑屏」。
优先级（Priority）	根据问题严重程度选择，如 Blocker、Critical、Major、Minor、Trivial。
严重程度（Severity）	区分于优先级，描述问题对功能的影响程度，如致命、严重、一般、轻微。
组件/模块（Component）	选择问题所属的子系统或组件，便于自动路由给对应开发负责人。
版本（Affects Version）	填写出现问题的软件版本或硬件版本。
环境（Environment）	填写测试环境信息，如实车、台架、仿真环境，以及车辆型号、配置等。

3.4 填写问题描述

描述区域建议按照以下结构组织，便于开发人员快速理解：

• 问题现象：描述实际发生的现象，包括错误提示、异常行为、画面表现等。
• 预期结果：说明按照需求或设计规范，系统本应表现出的正确行为。
• 实际结果：说明当前实际表现，与预期结果的差异。
• 复现步骤：按顺序列出可复现问题的操作步骤，步骤要具体、可执行。
• 复现概率：说明问题出现的频率，如必现、偶现（约 30%）、仅特定条件下出现。

3.5 上传附件

在附件区域上传日志文件、截图、录屏等材料。注意控制附件大小，必要时先压缩再上传。日志文件建议附带简要说明，标注关键时间点。

3.6 关联测试用例

如果项目启用了测试管理插件（如 Xray、Zephyr），可以在 Bug 中关联对应的测试用例，方便追溯问题来源和回归验证。

3.7 提交并通知相关人员

确认所有字段填写完整后，点击「创建」提交。提交后可在问题详情页通过「评论」补充信息，或通过「@提及」通知相关开发人员。

4. 提交 Bug 需要注意的关键点

4.1 摘要要精准

摘要是开发人员最先看到的信息，应做到「一眼看懂」。避免使用「有问题」「不工作」这类模糊描述，建议包含模块、现象和关键条件。

4.2 复现步骤要可执行

复现步骤必须让开发人员按照描述即可复现，避免遗漏前置条件。例如：

前置条件：车辆上电，中控屏处于主界面，连接手机蓝牙。
步骤：
1. 在蓝牙设置中连接手机；
2. 播放手机音乐；
3. 连续快速切换 5 次上一曲/下一曲；
4. 观察中控屏是否出现卡顿或黑屏。

4.3 日志与截图要对应

日志和截图应能支撑问题描述，建议在描述中标注关键时间点，方便开发人员快速定位日志中的异常段。例如「请查看 14:32:05 之后的 CAN 日志，总线报文异常」。截图应清晰展示问题现象，必要时用红框标注异常区域。

4.4 区分优先级与严重程度

优先级反映问题处理的紧急程度，严重程度反映问题对系统的影响范围。例如：安全气囊误触发属于严重程度致命、优先级最高；界面文案错别字属于严重程度轻微、优先级较低。不要将两者混为一谈。

4.5 一个 Bug 一条记录

避免在一个 Bug 中描述多个独立问题。如果发现多个问题，应分别创建多条 Bug，便于分别跟踪、指派和验证。若多个问题由同一根因导致，可在描述中注明关联关系。

4.6 及时补充与更新

Bug 提交后并非结束，测试人员应持续关注问题状态。当开发人员提出疑问时，及时补充信息；修复完成后，按计划进行回归验证，并在 Jira 中更新验证结果。

5. 常见问题与建议

• Bug 被退回：通常是因为信息不完整或无法复现，收到退回后应补充材料并重新提交，而不是直接关闭。
• 重复提交：提交前先搜索是否已有相同或相似的 Bug，避免重复，减少开发人员处理负担。
• 附件过大：日志文件过大时，可先截取关键时间段再上传，或上传到共享存储后在描述中附上路径。
• 跨模块问题：如果问题涉及多个模块，可在描述中说明，并建议项目管理员协调处理，而不是只指派给单一模块负责人。

6. 总结

通过 Jira 提交 Bug 是车载测试闭环管理的重要环节。规范的提交流程、完整的信息描述、清晰的复现步骤和有效的附件支撑，能够显著提升开发人员定位和修复问题的效率。测试人员应养成「一次提交、信息完整、可追溯」的习惯，让每一个 Bug 都能被快速理解和处理。