kaiyun.com App导入材料数据失败怎么办？EPD、CSV、单位和缺失数据排查

材料数据导入失败，十次里至少有八次和网络连接没有关系，而是数据本身的结构、单位或者字段命名和系统要求对不上。把这类问题当成"网络问题"反复重试上传，只会一直卡在同一个错误提示上——真正有效的排查方式，是先看清楚系统抛出的错误具体指向哪一类问题。

第一步：区分四类失败，而不是一律重试

开云App材料数据导入失败大致分四类：格式错误（文件本身无法解析，比如CSV编码不是UTF-8导致中文字段乱码）、字段缺失（必填字段没有对应列）、单位不匹配（数值存在但单位和系统预期不一致）、数值超出合理区间（比如强度值填成了负数或者碳排放数值明显偏离常见范围）。系统的错误提示会标注具体是哪一类，第一步永远是先看错误提示对应哪一类，而不是不管什么错误都点"重新上传"。

最常见原因一：EPD字段命名和系统模板不一致

很多用户直接把供应商提供的EPD原始PDF数据摘抄成CSV，但EPD报告里的字段命名（比如"Global Warming Potential (GWP-total)"）和开云App材料模板要求的字段名（"碳排放_kgCO2e_每功能单位"）不是逐字对应关系。系统按模板列名读取数据，如果找不到匹配的列名，会把对应字段判定为缺失，即使实际数值已经写在表格里。排查方法是打开系统提供的导入模板文件，逐列核对模板要求的字段名，把EPD原始数据里的对应数值搬到正确的列，而不是保留EPD原始的英文列名直接上传，这和EPD数字不能直接拿来排高低是同一类"原始数据不能直接套用"的问题。

最常见原因二：kgCO2e、tCO2e和体积、质量、强度单位混用

这是导入失败里最隐蔽的一类，因为数据"看起来"是对的，系统却提示数值超出合理区间。常见情况包括：把以"吨CO2e"为单位记录的数字直接填进要求"千克CO2e"的字段，导致数值相差1000倍；把混凝土的强度单位从"兆帕（MPa）"错填成"千克力/平方厘米（kgf/cm²）"，两者数值比例约为1:10.2，容易造成强度看起来异常偏高；把材料用量按"立方米"记录却填进要求"千克"的字段，如果没有同时提供材料密度，系统无法自动换算，会直接报错。排查这类问题的具体方法是：先确认系统模板每一列标注的单位（模板表头通常会用括号注明，比如"碳排放（kgCO2e/m³）"），逐列核对自己填写的原始数据单位是否一致，重点检查是否存在"吨"和"千克"、"兆帕"和"千克力每平方厘米"这类容易混淆的单位对。举例来说，如果某条混凝土数据的碳排放原始记录是0.31吨CO2e每立方米，正确填法是310千克CO2e每立方米，而不是直接填0.31。

还有一类不完全属于上述单位混淆、但同样常见的数字解析问题：部分用户从国外供应商的Excel表格复制数据时，数字里包含千分位分隔符，比如"1,900.00"这种写法，如果CSV解析器把逗号当成字段分隔符，一个本应是一列的数字会被拆成两列，导致后面所有列全部错位，报错信息往往显示为"字段数量与模板不符"而不是直接指向数值本身的问题。系统内置了一层预处理逻辑，检测到数值字段里包含逗号但整行列数超出模板预期时，会尝试识别并自动处理千分位分隔符，但如果原始表格里逗号使用不规范（比如中英文逗号混用，或者小数点被写成逗号，这在部分欧洲供应商的原始数据里很常见），系统仍然可能处理失败，此时需要用户先在表格软件里统一替换掉数字里的千分位分隔符和小数点写法，再重新导出CSV文件。

最常见原因三：缺失值不是留空就能过关

材料数据里最常见的缺失字段是运输距离、生产商所在地、再生成分比例这三项。系统对缺失值的处理规则是：核心字段（材料类别、强度、碳排放数值）缺失会直接判定导入失败；非核心字段（运输距离、再生比例）缺失时，系统允许导入，但会用系统默认区间值填充，并在材料详情页标注"该字段为系统估算，非用户提供数据"。用户如果想避免被系统估算值覆盖真实情况，需要至少提供一个大致区间，而不是完全留空，比如运输距离不确定具体公里数，可以填写"200—500公里"这样的区间，而不是空白，空白会被系统按行业平均运输距离（通常预设为300公里）处理，可能和实际情况有明显偏差。再生成分比例缺失时的处理逻辑类似：系统默认按材料类别对应的行业平均再生比例填充——钢材默认约30%，铝材默认约30%，如果用户明确知道自己材料的再生比例高于或低于这个默认值却未填写，系统估算结果可能与实际情况偏差超过10个百分点，直接影响后续碳排放计算的准确性，这也是为什么系统会在估算值旁边持续标注"系统估算"而不是让用户误以为这是真实申报数据。

一次模拟排查：CSV导入报错到修正成功的完整过程

以下为模拟场景，不对应真实用户案例。某用户上传一份包含12种钢材数据的CSV文件，系统报错"第4行、第7行数值超出合理区间"。排查发现，第4行强度值填写为3550（预期单位兆帕），实际应为355兆帕，原始数据来源里这个数字本身是以"kgf/cm²"为单位记录的屈服强度，用户直接照抄未换算；第7行碳排放数值填写为0.85（预期单位kgCO2e/kg），但该行材料实际是再生比例80%的废钢型材，正常数值范围应在0.6—1.0之间，0.85本身没有超出常规区间，报错原因其实是该行运输距离列被误填成文字"待定"而不是数字，导致整行解析失败。修正方式分别是：第4行按1兆帕≈10.2千克力每平方厘米的比例换算回355兆帕；第7行把运输距离列的"待定"替换为具体数字或者留空使用系统估算，两处修正后重新上传，文件顺利导入。

运输距离和产地信息，是最容易被忽视也最影响结果的两项

很多用户觉得运输距离和产地是无关紧要的辅助信息，实际上这两项直接影响碳排放计算里物流环节的占比，对于铝材、钢材这类单位质量碳排放本身就较高的材料，运输距离误差500公里可能导致最终碳排放数字偏差5%以上。导入数据时，如果暂时无法获得精确产地信息，比较稳妥的做法是填写供应商所在省份或城市这一级别的信息，而不是完全空缺，这样至少可以让系统按照更小的区域范围估算运输距离，而不是套用全国平均值。