含单引号与空格的文件名致SharePoint jQuery上传URL错误求助

这个报错的核心原因是文件名中的单引号和空格没有正确转义，直接破坏了SharePoint REST API的OData查询语法结构。咱们一步一步来解决：

问题根源 #

你当前直接把含特殊字符的文件名拼进URL里，比如fileName="Test ' "会让最终的URL片段变成：

.../add(overwrite=true, url='Test ' '.jpg')

这里的单引号提前闭合了url参数的字符串，导致SharePoint无法解析这个无效的OData表达式；空格作为URI中的特殊字符，也会进一步干扰解析逻辑。

解决方案：正确转义特殊字符 #

针对SharePoint REST API的规则，我们需要做两个关键处理：

1. 将文件名中的单引号替换为两个单引号（这是OData规范中，字符串内单引号的标准转义方式）
2. 将空格编码为%20（符合URI标准，避免解析歧义）

修改你的代码如下：

// 1. 先处理文件名的特殊字符
var escapedFileName = fileName
  .replace(/'/g, "''") // 把单个单引号转成两个单引号
  .replace(/ /g, "%20"); // 把空格编码为URI标准的%20

// 2. 构造合法的请求URL
var fileCollectionEndpoint = String.format(
  "{0}/_api/web/getfolderbyserverrelativeurl('{1}')/files/add(overwrite=true, url='{2}')",
  serverUrl,
  serverRelativeUrlToFolder,
  escapedFileName
);

// 3. 发起POST请求（保留你原有的ajax逻辑即可）
jQuery.ajax({
  url: fileCollectionEndpoint,
  type: "POST",
  // 补充你的其他配置：headers、processData等
})
.done(function(data) {
  console.log("上传成功", data);
})
.fail(function(error) {
  console.error("上传失败", error);
});

额外优化：用请求体传递参数（更可靠） #

如果经常遇到特殊字符的问题，推荐改用addUsingPath方法，通过请求体传递参数，完全避免URL编码的麻烦：

var fileCollectionEndpoint = String.format(
  "{0}/_api/web/getfolderbyserverrelativeurl('{1}')/files/addUsingPath(overwrite=true)",
  serverUrl,
  serverRelativeUrlToFolder
);

jQuery.ajax({
  url: fileCollectionEndpoint,
  type: "POST",
  contentType: "application/json;odata=verbose",
  data: JSON.stringify({
    path: {
      DecodedUrl: fileName // 直接用原始文件名，无需手动转义
    }
  }),
  // 补充你的headers等配置
});

这种方式下，文件名中的单引号和空格会通过请求体的JSON格式自动处理，无需手动转义，更不容易出错。

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