读取CSV生成Facturae电子发票时遇cvc-datatype-valid.1.2.1错误

错误原因分析 #

这个cvc-datatype-valid.1.2.1错误是XML Schema（XSD）验证环节抛出的，核心问题很明确：你CSV里某个对应XML模板中double类型的字段是空字符串（''），但XML Schema定义要求该字段必须是有效的双精度数值，空字符串不满足这个约束条件。

通常这类字段是金额、税率、数量这类数值型数据，CSV里的空值可能表现为连续的分号（比如;;），代表中间的字段没有值，很容易被忽略。

分步解决方案 #

1. 定位问题字段 #

先把CSV文件打开（用Excel或文本编辑器都可以），检查所有对应XML中double类型的列：

• 找存在空值的行和列，比如金额列、单价列这些数值型字段有没有空单元格；
• 重点留意分号分隔的格式，比如123;;456这种情况，中间的字段就是空值。

2. 修复数据或调整XML约束 #

根据空值的合法性来处理：

• 如果空值是数据错误：直接补全正确的double数值，比如空的金额字段填0.0，或者对应的实际业务数值；
• 如果空值是合法的可选值：需要检查XML Schema的定义，把对应元素设置为允许空值：
  • 要么给元素加上nillable="true"属性，这样可以用<字段名 xsi:nil="true"/>的形式表示空值；
  • 要么设置minOccurs="0"，表示该元素可以不出现。

举个XSD修改的例子：
原定义（不允许空）：

<xs:element name="TotalAmount" type="xs:double"/>

修改后（允许空值）：

<xs:element name="TotalAmount" type="xs:double" nillable="true"/>

3. 在代码中加入空值处理逻辑 #

在读取CSV生成XML的代码里，提前拦截空字符串，避免触发验证错误：
比如用Python处理的话，可以这样写：

import csv
import xml.etree.ElementTree as ET

with open('facturae_data.csv', 'r', encoding='utf-8') as csvfile:
    reader = csv.DictReader(csvfile, delimiter=';')
    for row in reader:
        # 处理金额字段，假设字段名为total_amount
        total_amount = row['total_amount'].strip()
        invoice = ET.Element('Invoice')
        amount_elem = ET.SubElement(invoice, 'TotalAmount')
        if not total_amount:
            # 如果允许空值，添加nil属性
            amount_elem.set('{http://www.w3.org/2001/XMLSchema-instance}nil', 'true')
        else:
            # 确保是合法的double值
            try:
                float(total_amount)
                amount_elem.text = total_amount
            except ValueError:
                # 处理非数值的非法数据
                print(f"Invalid double value: {total_amount} in row {reader.line_num}")

这样就能在生成XML时提前处理空值，避免触发Schema验证错误。

内容的提问来源于stack exchange，提问作者AER