SharePoint REST API批量删列表项遇0x80131904及500错误求助

嘿，我碰到过类似的坑，咱们一步步来搞定它！你遇到的Exception from HRESULT: 0x80131904异常和批量删除时的500错误，核心原因是并发请求过载导致服务器压力过大，再加上删除操作时没正确处理项的冲突校验（ETag），那个0x80131904通常和SharePoint后端SQL数据库的锁冲突、超时有关。

问题根源拆解 #

你原来的逻辑是先拉取所有列表项，然后循环发起删除请求——这种并行多请求会瞬间给服务器造成冲击，当项数超过5个时，服务器就会因过载返回500错误；而0x80131904多数是频繁操作触发了SQL数据库的锁资源占用异常。

解决方案1：使用OData批量请求（推荐） #

SharePoint支持把多个删除请求打包成一个批量请求发送，大幅减少请求次数，从根源上避免服务器过载。

下面是完整的批量删除代码示例：

function deleteAllListItems(listTitle) {
    const webUrl = _spPageContextInfo.webAbsoluteUrl;
    const batchUrl = `${webUrl}/_api/$batch`;
    
    // 先获取所有列表项的ID和ETag（用于冲突校验）
    $.ajax({
        url: `${webUrl}/_api/web/lists/getByTitle('${listTitle}')/items?$select=Id,__metadata`,
        type: "GET",
        headers: { "accept": "application/json;odata=verbose" },
        success: (data) => {
            const items = data.d.results;
            if (items.length === 0) {
                console.log("列表为空，无需删除");
                return;
            }
            
            // 构建批量请求的边界标识
            const batchId = `batch_${Math.random().toString(36).substring(2,15)}`;
            const changeSetId = `changeset_${Math.random().toString(36).substring(2,15)}`;
            const batchContent = [];
            
            // 批量请求头部
            batchContent.push(`--${batchId}`);
            batchContent.push(`Content-Type: multipart/mixed; boundary=${changeSetId}`);
            batchContent.push("");
            
            // 为每个列表项添加删除请求片段
            items.forEach(item => {
                const deleteUrl = `/api/web/lists/getByTitle('${listTitle}')/items(${item.Id})`;
                batchContent.push(`--${changeSetId}`);
                batchContent.push("Content-Type: application/http");
                batchContent.push("Content-Transfer-Encoding: binary");
                batchContent.push("");
                batchContent.push(`DELETE ${deleteUrl} HTTP/1.1`);
                batchContent.push("Accept: application/json;odata=verbose");
                batchContent.push(`If-Match: ${item.__metadata.etag}`); // 带ETag做冲突校验
                batchContent.push("Content-Length: 0");
                batchContent.push("");
            });
            
            // 结束批量请求的边界标识
            batchContent.push(`--${changeSetId}--`);
            batchContent.push(`--${batchId}--`);
            
            // 发送批量请求
            $.ajax({
                url: batchUrl,
                type: "POST",
                headers: {
                    "X-RequestDigest": $("#__REQUESTDIGEST").val(),
                    "Content-Type": `multipart/mixed; boundary=${batchId}`
                },
                data: batchContent.join("\r\n"),
                success: () => console.log("所有项删除成功！"),
                error: (xhr) => console.log(`删除失败：${xhr.responseText}`)
            });
        },
        error: (xhr) => console.log(`获取列表项失败：${xhr.responseText}`)
    });
}

// 调用方法
deleteAllListItems("TestList");

解决方案2：串行异步删除（适合少量项场景） #

如果不想用批量请求，也可以改成串行删除，每次只处理一个项，避免并发压力：

function deleteItemsSerially(items, listTitle, index = 0) {
    if (index >= items.length) {
        console.log("所有项删除完成");
        return;
    }
    
    const item = items[index];
    const deleteUrl = `${_spPageContextInfo.webAbsoluteUrl}/_api/web/lists/getByTitle('${listTitle}')/items(${item.Id})`;
    
    $.ajax({
        url: deleteUrl,
        type: "DELETE",
        headers: {
            "accept": "application/json;odata=verbose",
            "X-RequestDigest": $("#__REQUESTDIGEST").val(),
            "If-Match": item.__metadata.etag
        },
        success: () => deleteItemsSerially(items, listTitle, index + 1),
        error: (xhr) => {
            console.log(`删除项ID ${item.Id} 失败：${xhr.responseText}`);
            // 可选：继续删除下一个项，或者终止流程
            deleteItemsSerially(items, listTitle, index + 1);
        }
    });
}

// 调用示例
$.ajax({
    url: `${_spPageContextInfo.webAbsoluteUrl}/_api/web/lists/getByTitle('TestList')/items?$select=Id,__metadata`,
    type: "GET",
    headers: { "accept": "application/json;odata=verbose" },
    success: (data) => deleteItemsSerially(data.d.results, "TestList")
});

关键注意事项 #

• 必须携带ETag：删除请求的If-Match头是核心，它能避免删除过程中其他用户修改项导致的冲突；如果不需要冲突校验，也可以用*代替ETag，但生产环境不建议这么做。
• 请求Digest不可少：所有POST/DELETE请求必须带上X-RequestDigest头，直接取页面上#__REQUESTDIGEST元素的值即可。
• 批量请求限制：SharePoint的批量请求一般最多支持100个操作，如果列表项超过100，可以拆分多个批次处理。

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