符合国家标准电子档案交换规范的系统对接落地实操全指南

一、前置准备工具与依赖

对接前请准备好以下工具和文件，所有资源都可以直接获取，无额外付费要求：

• JDK1.8及以上版本：Ubuntu系统执行命令sudo apt install openjdk-17-jdk安装，Windows用户直接从https://adoptium.net/temurin/releases/下载对应安装包，默认下一步安装即可
• Maven3.6及以上版本：直接从https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.zip下载，解压后配置系统环境变量即可
• 电子档案交换规范官方XSD schema文件：从国家档案局官网下载http://www.saac.gov.cn/xxgk/tzgg/202210/P0202210123479288.zip，解压后得到合规校验用的XSD文件

二、核心对接步骤实操

2.1 项目依赖配置

如果是Maven项目，直接把以下依赖复制到pom.xml的dependencies节点下，用于XML解析和合规校验：

``` org.dom4j dom4j 2.1.3 jaxen jaxen 1.2.0 javax.xml jaxp-api 1.4.2 ```

2.2 创建规范要求的交换包目录结构

电子档案交换规范要求固定目录结构，直接按照以下结构创建即可，所有名称必须小写，禁止使用中文空格和特殊字符：

• 根目录：命名规则为发送单位代码_4位年份_6位流水号，示例：11010000_2024_000001
• ├─ metadata.xml （必填，核心元数据文件）
• ├─ content/ （必填，存放所有电子档案实体文件）
• └─ signature.xml （可选，要求电子签名时添加）

2.3 编写合规的核心元数据文件

metadata.xml必须严格遵循XSD约束，以下是可直接复用的完整模板，替换括号外的占位内容即可：

``` 11010000_2024_000001 XX单位档案管理部门 11010000 XX接收单位档案管理部门 11010001 2024-05-20 15 1024 ARCH00001 2024 content/ARCH00001.pdf 1024 86be76923862a2a4d824eb4d97f0b99c ```

说明：每个实体文件必须计算MD5值填入对应节点，用于接收方校验文件完整性，不能省略；totalCount填本次交换的档案总数量，totalSize填所有文件总大小，单位为KB。

2.4 本地合规校验

编写完成后，先做本地校验避免被接收方驳回，以下是可直接运行的校验代码，复制到项目中即可使用：

``` import javax.xml.transform.Source; import javax.xml.transform.stream.StreamSource; import javax.xml.validation.Schema; import javax.xml.validation.SchemaFactory; import javax.xml.validation.Validator; import java.io.File; public class ExchangeValidator { public static boolean validate(String xmlPath, String xsdPath) throws Exception { SchemaFactory factory = SchemaFactory.newInstance("http://www.w3.org/XML/XMLSchema/v1.1"); Schema schema = factory.newSchema(new File(xsdPath)); Validator validator = schema.newValidator(); Source source = new StreamSource(new File(xmlPath)); try { validator.validate(source); return true; } catch (Exception e) { System.out.println("校验不通过，原因：" + e.getMessage()); return false; } } public static void main(String[] args) { // 替换为你本地的实际文件路径 String xmlPath = "D:/exchange/11010000_2024_000001/metadata.xml"; String xsdPath = "D:/exchange/ebexchange.xsd"; try { boolean result = ExchangeValidator.validate(xmlPath, xsdPath); System.out.println("校验结果：" + (result ? "合规" : "不合规")); } catch (Exception e) { e.printStackTrace(); } } } ```

运行main方法，输出“合规”说明元数据符合规范，根据错误提示修改对应内容即可。

2.5 打包导出

校验通过后，直接打包交换目录：必须使用标准ZIP压缩格式，禁止使用RAR、7Z等其他格式；压缩时不能嵌套根目录，即解压后直接得到metadata.xml和content目录，不能出现一层额外的同名根文件夹。

三、常见问题排查

• 校验提示节点不匹配：检查XML的命名空间是否和模板一致，确认XSD文件路径填写正确，重新下载完整的官方XSD文件。
• 接收方提示MD5不匹配：重新计算文件MD5，修改文件后必须更新对应MD5值，不要复用旧值。
• 接收方解压失败：检查压缩格式是否为标准ZIP，确认压缩时没有嵌套多余根目录，压缩包名称不要使用中文特殊字符。
• 接收方解析失败：确认XML编码为UTF-8，不要使用GBK或其他编码格式。

四、最终交付验证

完成打包后，执行以下三步做最终验证： 1. 将压缩包重新解压到新的空白目录 2. 重新运行本地校验代码，确认输出合规 3. 随机抽取1-2个档案文件，重新计算MD5比对确认一致 完成以上三步即可交付，接收方可以直接按照规范解析交换包，不会出现对接错误。