CSOM上传XML最稳妥，需设ContentStream和.xml后缀，启用自定义脚本；REST上传须移除DOCTYPE声明并用multipart/form-data；解析需下载二进制流后用UTF8解码再XDocument解析。
CSOM 上传 XML 文件到文档库
CSOM 是最稳妥的上传方式，尤其适合需要保持文件元数据、权限继承或批量操作的场景。XML 文件本质是二进制流，和上传 .txt 或 .csv 没区别，但要注意 Content-Type 和文件扩展名是否被 SharePoint 服务端拦截。
关键点：FileCreationInformation 必须设置 ContentStream（不能用字符串直接赋值），且 Url 字段要包含 .xml 后缀；否则上传成功但可能无法下载或触发解析失败。
- 确保目标文档库允许上传
.xml文件（默认部分租户禁用，需在 SharePoint 管理中心 →More features→Custom Script开启，或由管理员在Site Settings → Site Collection Features中启用「自定义脚本」） - 使用
Web.GetFolderByServerRelativeUrl()获取目标文件夹，避免硬编码 URL 路径中的空格或编码问题 - 上传后建议调用
file.ListItemAllFields.Update()并执行context.ExecuteQuery()，确保后续能通过 REST 获取元数据
var fileCreationInfo = new FileCreationInformation
{
ContentStream = new MemoryStream(Encoding.UTF8.GetBytes(xmlContent)),
Url = "config.xml",
Overwrite = true
};
var folder = context.Web.GetFolderByServerRelativeUrl("/sites/demo/Shared Documents");
var uploadFile = folder.Files.Add(fileCreationInfo);
context.Load(uploadFile);
context.ExecuteQuery();
REST API 上传 XML 文件（无 CSOM 环境）
REST 方式更轻量，适合前端或无 .NET 运行时的场景，但必须注意：SharePoint Online 默认会阻止某些 MIME 类型的 XML 上传，尤其是带 DTD 或 DOCTYPE 声明的文件。错误现象通常是 403 Forbidden 或 500 Server Error，响应体里含 "The file is not supported for security reasons."
解决办法不是改请求头，而是调整 XML 内容本身：
- 移除所有
/code> 和 <code><?xml version=...>声明（SharePoint REST 对 XML 声明敏感，即使合法也会被拦截） - 确保
Content-Type请求头设为application/xml或text/xml，但实际上传时用multipart/form-data更可靠 - 上传 endpoint 必须用
_api/web/getfolderbyserverrelativeurl('/path')/files/add(url='a.xml',overwrite=true)，不能省略url=参数
fetch("https://contoso.sharepoint.com/_api/web/getfolderbyserverrelativeurl('/sites/demo/Shared%20Documents')/files/add(url='settings.xml',overwrite=true)", {
method: "POST",
headers: {
"Accept": "application/json;odata=verbose",
"X-RequestDigest": digest,
},
body: xmlBlob // Blob 对象，内容为纯 XML 元素（无声明、无 BOM）
});
解析已上传的 XML 文件内容（CSOM + REST 混合）
SharePoint 不提供内置 XML 解析服务，所谓“解析”是指：读取文件内容 → 在客户端或服务端解析成对象。不能直接用 CSOM 的 ListItem 获取 XML 结构，必须先下载原始流。
CSOM 下载需注意：File.OpenBinaryStream() 返回的是 ClientResult<stream></stream>，必须用 context.ExecuteQuery() 触发传输，且流不可重复读 —— 建议立即转成 string 或 XDocument：
- 若 XML 含中文，务必用
Encoding.UTF8.GetString(streamBytes)，不要依赖默认编码（可能为 ASCII 导致乱码） - REST 获取文件内容用
_api/web/getfilebyserverrelativeurl('/path.xml')/$value，响应是 raw binary，前端需用response.arrayBuffer()转换，再用new TextDecoder().decode() - 避免在浏览器中直接用
DOMParser解析含命名空间或 CDATA 的 XML，推荐用fast-xml-parser或服务端System.Xml.Linq.XDocument
var file = context.Web.GetFileByServerRelativeUrl("/sites/demo/Shared Documents/config.xml");
var stream = file.OpenBinaryStream();
context.ExecuteQuery();
using (var reader = new StreamReader(stream.Value, Encoding.UTF8))
{
string xmlText = reader.ReadToEnd();
var doc = XDocument.Parse(xmlText); // 可靠解析
}
常见失败原因和绕过方式
很多“上传失败”或“解析为空”其实和代码无关，而是 SharePoint 的安全策略在起作用：
-
404 Not Foundon/files/add：检查 URL 中的文档库路径是否正确，Shared Documents在现代站点中实际 URL 是Shared%20Documents，空格未编码会导致 404 -
403 Forbiddenon XML upload：确认租户级策略未禁用 XML（PowerShell 查：Get-SPOTenant | Select DisableCustomScript；若为True，需等 24 小时生效或联系管理员） - 下载后 XML 内容变成 HTML 错误页：说明文件被 SharePoint 当作可执行内容拦截，此时只能改文件扩展名（如
.xml.txt）再上传，解析前手动截掉后缀 - CSOM 中
ExecuteQuery()报Microsoft.SharePoint.Client.ServerUnauthorizedAccessException：不是权限不足，而是 App-Only 权限未包含Files.ReadWrite.All（而非仅Sites.Read.All）
XML 文件在 SharePoint 里只是容器，真正复杂的是权限、编码、MIME 策略和跨域上下文 —— 别在解析逻辑里花太多时间，先确保它能干净地传进去、取出来。
