Google Apps Script上传图片到WordPress报rest_upload_sideload_error错误求解

核心问题原因 #

你的代码存在两处关键错误导致WordPress无法正确识别上传的PNG文件格式：

• 错误地对文件二进制内容做了Base64编码后直接传输，且未声明编码格式：WordPress REST API的/wp/v2/media端点默认接收原始二进制文件流，你传输Base64字符串时没有对应声明编码规则，服务器会直接将Base64字符串当做文件内容存储，无法识别为PNG格式。
• Content-Disposition请求头格式不符合规范：filename参数的取值需要用双引号包裹，否则部分服务器解析文件名时会出错，进而导致后缀校验失败。

修正后可用代码 #

function test3() {
    const png = DriveApp.getFileById('你的PNG文件ID');
    const parm = {};
    parm.method = "post";
    parm.headers = {
        "Authorization": "Basic " + Utilities.base64Encode('用户名' + ':' + '应用密码'),
        // 修正filename的引号包裹规则
        "Content-Disposition": "attachment; filename=\"你的文件名.png\"",
        "Content-Type": "image/png",
        "Accept": "application/json",
        "cache-control": "no-cache"
    };
    // 直接传入Blob对象，不需要额外做Base64编码
    parm.payload = png.getBlob();
    parm.muteHttpExceptions = false;
    const x = UrlFetchApp.fetch("https://你的站点域名/wp-json/wp/v2/media", parm);
    Logger.log(x.getContentText());
}

若修改后仍报错，按以下顺序排查 #

1. 先手动将你要上传的同一个PNG文件上传到WordPress后台媒体库，确认文件本身无损坏、站点默认允许PNG格式上传，排除站点全局配置问题。
2. 确认你生成Basic认证所用的用户账号拥有「上传文件」权限（至少为编辑者或管理员角色）。
3. 检查站点是否安装了安全类插件、WAF规则，是否拦截了REST API的媒体上传请求，或者自定义了文件类型校验逻辑。
4. 若业务场景确实需要传输Base64格式的内容，需要在请求头中添加"Content-Transfer-Encoding": "base64"，再使用Base64编码后的内容作为payload。

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