做需求导入时，失败多半不是文件坏了，而是数据口径与项目配置对不上，导入向导能读到表格但无法把值落到正确字段。你只要先把失败点归类为字段缺失、取值不合法、映射不匹配三大类，再按模板把字段清洗到同一口径，导入成功率会稳定很多。

　　一、Polarion导入需求失败是什么原因

　　导入失败先别急着重试，同一份表格反复导只会把问题放大；正确做法是先锁定导入对象和映射规则，再回到表里把导致失败的字段逐个清掉。

　　1、工作表结构不符合导入预期

　　检查是否做到一行对应一条需求，列对应Polarion字段，是否把表头行当成数据行导入，是否选错导入起始单元格；起始单元格如果落在表头里，后续映射再对也会出现大量异常。

　　2、列名能看到但字段映射没有落到正确字段

　　导入向导需要把Excel列映射到Work Item字段，如果某些列没有被映射，或者映射到错误字段，比如把摘要映射到描述，把状态映射到严重级别，就会出现创建失败或导入结果混乱。

　　3、存在项目里没有的字段或自定义字段未提前建好

　　表格里有列想导入，但项目配置里没有对应字段时，需要管理员先在项目里新增自定义字段，否则导入时即使看起来能选列，也无法正确存储该列数据。

　　4、字段取值不在允许范围或类型不匹配

　　常见是枚举字段写了项目里不存在的值，比如状态、优先级、需求类型，或日期字段混用文本与数字格式；导入向导在映射时会尝试识别并转换，但超出口径就会报错或跳过。

　　5、把外部ID当成Polarion主键使用导致冲突

　　很多表里自带编号列，但Polarion在导入创建时会给新Work Item分配自己的ID，如果你把外部编号硬映射到ID类字段，容易出现重复、不可写或关联失败；外部编号更适合映射到自定义字段做追溯。

　　二、Polarion导入需求怎么按模板清洗字段

　　按模板清洗的核心是先确定字段口径，再把Excel里每一列的数据变成Polarion能接受的格式与取值，最后用预览验证映射结果，不要把清洗工作留到导入后返工。

　　1、先用导入目标反推模板列清单

　　在Excel里保留真正要导入的列，确保每一列都能对应到Polarion的某个字段；如果某列只是你们内部备注，先标记为不导入或准备映射到自定义字段，避免导入时临时加列导致映射混乱。

　　2、先补齐项目里缺失的自定义字段再清洗数据

　　用管理员账号进入【Administration】，找到Work Item字段与自定义字段配置，把模板里必须落库的列先建成自定义字段，再回到Excel按字段类型清洗，比如文本、枚举、日期分别用不同方式处理。

　　3、把枚举字段做成受控口径

　　在Excel新增一张对照表，把状态、优先级、类型等枚举值写成项目里真实存在的值；回到主表选中对应列，使用【数据】里的【数据验证】把可选值限制在对照表范围内，避免手写拼错或出现空格差异。

　　4、清理空值与必填字段

　　把摘要或标题一类必填列先筛选空白，使用【筛选】定位空行并补齐或删除；对需要默认值的列先统一填充，比如没有优先级就填一个你们约定的默认值，避免导入时出现大量跳过。

　　5、统一日期与数字为可导入口径

　　日期列先全列设置为同一日期格式，再用【查找和替换】把斜杠日期替换为连字符日期，避免同列混用多种写法；数字枚举如果计划映射到文本枚举，先准备一列映射值，导入时直接导映射后的文本列。

　　6、去掉会干扰解析的表格特性

　　把合并单元格全部取消合并，公式列用复制后选择性粘贴为数值，单元格内多余换行与前后空格用【查找和替换】清掉，保证导入向导读取到的是稳定的纯数据而不是样式和计算结果。

　　三、Polarion导入规则与预览验证

　　字段清洗完成后，不建议直接点导入就放行，先把导入规则跑通并用预览看结果，确认映射正确再执行导入，能省掉后续批量回滚与补录。

　　1、用导入向导把范围选对

　　在Polarion里进入需求所在位置，点击【Import】选择【Excel】，在向导里指定从哪个单元格开始导入，确认表头存在时勾选表头选项，起始单元格不要落在表头行。

　　2、按需求类型设置导入规则并完成字段映射

　　在规则里先选Work Item类型，再用【+】添加条件，随后从左到右把每一列映射到字段；遇到枚举转换时，按向导提示把Excel值逐个映射到Polarion枚举值，避免导入后出现空值。

　　3、先用【Preview】跑通结果再导入

　　点击【Preview】查看导入预览，优先检查标题、类型、状态、关键自定义字段是否落到正确位置；预览只展示部分匹配项，用它来快速发现映射错误与取值不合法问题，再回表修正后重新预览。

　　4、保存导入配置便于复用并执行导入

　　预览结果符合预期后，在向导里通过设置入口保存Import Configuration，下一次同类表格可直接复用同一套映射与规则；最后点击【Import】执行导入，导入后优先检查失败与跳过条目对应的字段列，再按同一配置补导。

　　总结

　　Polarion导入需求失败通常来自表格结构、字段映射、项目字段配置与取值口径不一致，解决路径是先按模板把列与字段口径定死，再把枚举、日期、必填与自定义字段清洗到可导入状态，最后用导入向导的规则映射与【Preview】把错误挡在导入前。