自定义Content-Type的boundary未应用到Request Payload问题排查

这不是配置错误，是浏览器的标准行为+部分版本实现逻辑偏差共同导致的：

• 当你给XMLHttpRequest.send()传入FormData实例作为请求体时，按照XHR规范要求，浏览器会全权接管multipart/form-data格式的编码工作：自动生成不会和传输内容冲突的随机boundary，用这个boundary拼接请求体，同时自动写入正确的Content-Type头，这整个过程中你通过setRequestHeader()手动设置的Content-Type头里的boundary参数会被直接忽略。
• 如果你手动给Content-Type写死了带自定义boundary的值，部分Chrome、Firefox版本会出现逻辑bug：它识别到你手动指定了boundary，就跳过了“自动写入带正确boundary的Content-Type头”这一步，但拼接请求体的时候依然用自己生成的随机boundary，最终导致请求头里声明的boundary和请求体实际使用的分隔符完全不匹配，PHP端按照头里的boundary解析请求体找不到任何分隔标记，自然会读到空字符串。
• 你给整个Content-Type值包裹双引号的操作，本质是让浏览器无法识别这是标准的multipart/form-data头，因此不会触发头覆写逻辑，你设置的头值会被原样发送；但因为你传入的还是FormData实例，浏览器依然会按默认逻辑用自动生成的boundary拼接请求体，最终还是头体分隔符不匹配，只是这时候头值被原样透传了而已，自定义boundary根本没作用到请求体上。
• 如果你只设置Content-Type: multipart/form-data不指定boundary，浏览器的自动流程会正常执行：自动生成boundary、自动把头补全为带正确boundary的值、用对应boundary拼请求体，头体完全匹配，所以服务端可以正常解析数据。

如果一定要使用自定义boundary，必须绕开浏览器对FormData的自动编码逻辑，全程手动控制请求体拼接和请求头设置，参考实现如下：

// 自定义boundary，注意必须保证这个字符串绝对不会出现在任何待传输的字段值、文件内容中，否则会出现解析截断
const customBoundary = "aBoundaryString";
let requestBody = "";

// 拼接普通表单字段
requestBody += `--${customBoundary}\r\n`;
requestBody += `Content-Disposition: form-data; name="username"\r\n\r\n`;
requestBody += `test_user\r\n`;

// 如果需要传输文件，先通过FileReader读取文件为二进制/ArrayBuffer格式，再按相同格式拼接到requestBody中
// 所有字段拼接完成后，添加结束分隔符
requestBody += `--${customBoundary}--\r\n`;

const xhr = new XMLHttpRequest();
xhr.open("POST", "/api/submit");
// 手动设置Content-Type头，传入自定义boundary
xhr.setRequestHeader("Content-Type", `multipart/form-data; boundary=${customBoundary}`);
// 传入手动拼接好的请求体，不要传FormData实例，浏览器就不会触发自动编码、自动覆写头的逻辑
xhr.send(requestBody);

注意事项 #

• 浏览器默认自动生成随机boundary的核心原因，是避免分隔符和传输内容（尤其是用户上传的文件内容）冲突，自定义boundary如果选的太简单，很容易出现内容截断、解析失败的问题，非特殊需求不建议强行自定义boundary。
• 手动拼接包含文件的multipart请求体需要处理二进制编码、换行符等细节，实现成本较高，容易出现兼容问题。

补充说明：所有现代浏览器对FormData自动编码的逻辑都是统一的，和浏览器版本、是否携带文件没有关系，你观察到的不同设置下的表现差异，本质都是触发了不同的自动处理分支。

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