BizTalk Flat File Schema解析无正文记录文件报错解决

云上老周

2026-8-29

问题场景

我在处理一类固定结构的平面文件，结构组成如下：

带标记、竖线分隔的Header段
定长（positional）格式的正文Records段
定长（positional）格式的Footer段

包含正文的正常文件示例：

H|20220601|XXXX
CONTENT FIELD 1              CONTENT FIELD 2                CONTENT FIELD 3
CONTENT FIELD 1              CONTENT FIELD 2                CONTENT FIELD 3
F00001234

当收到不含任何正文记录、仅包含头和尾的文件时，始终会抛出如下解析错误：

原因：查找以下内容时遇到意外的流结尾：
Positional data（长度为X）
当前正在解析的定义为Records，错误发生位置的流偏移量为XX，行号为3，列号为0。

无正文记录的文件示例：

H|20220601|XXXX
F00001234

当前使用的Flat File Schema配置如下：

<xs:element name="Root">
    <xs:annotation>
        <xs:appinfo>
            <b:recordInfo suppress_trailing_delimiters="false" preserve_delimiter_for_empty_data="true" sequence_number="1" child_order="postfix" child_delimiter="0xD 0xA" child_delimiter_type="hex" structure="delimited"/>
        </xs:appinfo>
    </xs:annotation>
    <xs:complexType>
        <xs:sequence>
            <xs:annotation>
                <xs:appinfo>
                    <groupInfo xmlns="http://schemas.microsoft.com/BizTalk/2003" sequence_number="0"/>
                </xs:appinfo>
            </xs:annotation>
            <xs:element name="Header" maxOccurs="1" minOccurs="1">
                <xs:annotation>
                    <xs:appinfo>
                        <b:recordInfo suppress_trailing_delimiters="false" preserve_delimiter_for_empty_data="true" sequence_number="1" child_order="infix" child_delimiter="/" child_delimiter_type="char" structure="delimited" tag_name="H"/>
                    </xs:appinfo>
                </xs:annotation>
                <xs:complexType>
                    [...]
                </xs:complexType>
            </xs:element>
            <xs:element name="Records" maxOccurs="unbounded" minOccurs="0" nillable="true">
                <xs:annotation>
                    <xs:appinfo>
                        <b:recordInfo suppress_trailing_delimiters="false" preserve_delimiter_for_empty_data="true" sequence_number="2" structure="positional"/>
                    </xs:appinfo>
                </xs:annotation>
                <xs:complexType>
                    [...]
                </xs:complexType>
            </xs:element>
            <xs:element name="Footers" maxOccurs="1" minOccurs="1">
                <xs:annotation>
                    <xs:appinfo>
                        <b:recordInfo suppress_trailing_delimiters="false" preserve_delimiter_for_empty_data="true" sequence_number="3" structure="positional" tag_name="F" tag_offset="0"/>
                    </xs:appinfo>
                </xs:annotation>
                <xs:complexType>
                    [...]
                </xs:complexType>
            </xs:element>
        </xs:sequence>
    </xs:complexType>
</xs:element>

已经尝试将Records节点的minOccurs属性设置为0，同时配置nillable="true"，但错误仍然存在，需要找到正确的配置方式让pipeline可以正常处理无正文记录的文件场景。

解决方案

报错核心原因：BizTalk平面文件解析器处理无标记的定长记录节点时，无法自动预判当前行属于Records还是后续Footer，哪怕设置了minOccurs=0，解析器也会优先尝试按Records的定长规则读取内容，读到F开头的Footer行时匹配长度规则失败，就会抛出意外流结尾的错误，nillable属性对平面文件定长记录解析无效，不需要配置。
按以下步骤调整Schema即可解决：

修正Header节点的分隔符配置：当前Header的child_delimiter属性值写的是/，和示例中竖线分隔的实际结构不符，将其改为|，避免Header解析偏移影响后续节点判断。
用选择组（xs:choice）包裹Records和Footers节点，让解析器逐行匹配行类型：
1. 删除原sequence节点下直接挂载的Records、Footers两个子节点
2. 在原位置插入xs:choice节点，配置该节点属性minOccurs="0"、maxOccurs="unbounded"
3. 将Records、Footers节点移入choice节点内部，保留Footers的minOccurs="1"、tag_name="F"配置，Records保留minOccurs="0"、maxOccurs="unbounded"、structure="positional"配置，删除Records节点上多余的nillable="true"属性。

调整后的核心Schema结构参考：

<xs:sequence>
    <!-- Header节点仅修改child_delimiter为|，其余配置保持不变 -->
    <xs:element name="Header" maxOccurs="1" minOccurs="1">
        <xs:annotation>
            <xs:appinfo>
                <b:recordInfo suppress_trailing_delimiters="false" preserve_delimiter_for_empty_data="true" sequence_number="1" child_order="infix" child_delimiter="|" child_delimiter_type="char" structure="delimited" tag_name="H"/>
            </xs:appinfo>
        </xs:annotation>
        <xs:complexType>
            [...]
        </xs:complexType>
    </xs:element>
    <!-- 新增choice组实现行类型自动匹配 -->
    <xs:choice minOccurs="0" maxOccurs="unbounded">
        <xs:element name="Records" maxOccurs="unbounded" minOccurs="0">
            <xs:annotation>
                <xs:appinfo>
                    <b:recordInfo suppress_trailing_delimiters="false" preserve_delimiter_for_empty_data="true" sequence_number="2" structure="positional"/>
                </xs:appinfo>
            </xs:annotation>
            <xs:complexType>
                [...]
            </xs:complexType>
        </xs:element>
        <xs:element name="Footers" maxOccurs="1" minOccurs="1">
            <xs:annotation>
                <xs:appinfo>
                    <b:recordInfo suppress_trailing_delimiters="false" preserve_delimiter_for_empty_data="true" sequence_number="3" structure="positional" tag_name="F" tag_offset="0"/>
                </xs:appinfo>
            </xs:annotation>
            <xs:complexType>
                [...]
            </xs:complexType>
        </xs:element>
    </xs:choice>
</xs:sequence>

调整后解析器读取Header后的内容时，会逐行优先匹配带F标签的Footer节点，匹配成功就直接终止Records段解析，不会再强行按定长Records规则读取Footer行，即可正常处理无正文记录的文件。

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