iOS端Stripe文件上传问题：无法上传图片至Stripe服务器绑定账户

你现在遇到的核心问题是无法将图片上传到Stripe服务器并绑定到指定账户，我从你给出的代码片段里梳理了几个关键问题点，再对应给出修复建议：

1. 服务端文件读取与类型设置的常见错误 #

你的服务端代码里用了type: 'application/octet-stream'，但Stripe对于身份文件（identity_document）更推荐使用具体的图片MIME类型，比如image/jpeg、image/png，模糊的类型可能导致Stripe无法正确识别文件而拒绝上传。另外，最关键的问题：如果客户端传的是iOS本地沙盒路径，服务端根本不可能读取到这个路径下的文件——服务端和客户端是完全独立的环境，不能直接跨设备访问文件路径！

修复后的服务端代码示例（用文件上传中间件接收二进制）： #

const accountID = req.body.accountID;
// 用multer这类中间件接收客户端上传的文件，直接获取二进制buffer
const fileBuffer = req.file.buffer;
const fileName = req.file.originalname;
const mimeType = req.file.mimetype;

stripe.fileUploads.create(
  {
    purpose: 'identity_document',
    file: {
      data: fileBuffer,
      name: fileName,
      type: mimeType // 使用图片真实的MIME类型
    }
  },
  { stripe_account: accountID }
)
.then(file => {
  console.log('文件上传成功:', file.id);
})
.catch(err => {
  // 一定要打印详细错误信息，Stripe会返回具体拒绝原因
  console.error('上传失败详情:', err.message, err.details);
});

2. 客户端路径传递的错误修正 #

客户端不能直接传本地文件路径给服务端，正确的做法是把图片转换成二进制数据（或Base64），通过表单上传到服务端。

iOS客户端上传示例（用NSURLSession构建multipart请求）： #

// 先将UIImage转成JPEG二进制数据
UIImage *identityImage = [UIImage imageNamed:@"your_identity_image"];
NSData *imageData = UIImageJPEGRepresentation(identityImage, 0.8);
if (!imageData) {
    NSLog(@"图片转二进制失败");
    return;
}

// 构建上传请求
NSString *uploadUrl = @"你的服务端上传接口地址";
NSURL *url = [NSURL URLWithString:uploadUrl];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"POST"];

// 生成multipart分隔符
NSString *boundary = @"Stripe-Upload-Boundary-12345";
NSString *contentType = [NSString stringWithFormat:@"multipart/form-data; boundary=%@", boundary];
[request setValue:contentType forHTTPHeaderField:@"Content-Type"];

NSMutableData *requestBody = [NSMutableData data];
// 添加accountID参数
[requestBody appendData:[[NSString stringWithFormat:@"--%@\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[requestBody appendData:[[NSString stringWithFormat:@"Content-Disposition: form-data; name=\"accountID\"\r\n\r\n%@\r\n", @"你的目标账户ID"] dataUsingEncoding:NSUTF8StringEncoding]];
// 添加图片文件
[requestBody appendData:[[NSString stringWithFormat:@"--%@\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[requestBody appendData:[[NSString stringWithFormat:@"Content-Disposition: form-data; name=\"file\"; filename=\"identity.jpg\"\r\n"] dataUsingEncoding:NSUTF8StringEncoding]];
[requestBody appendData:[[NSString stringWithFormat:@"Content-Type: image/jpeg\r\n\r\n"] dataUsingEncoding:NSUTF8StringEncoding]];
[requestBody appendData:imageData];
[requestBody appendData:[[NSString stringWithFormat:@"\r\n--%@--\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];

[request setHTTPBody:requestBody];

// 发送请求
NSURLSessionDataTask *uploadTask = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    if (error) {
        NSLog(@"客户端上传失败: %@", error.localizedDescription);
        return;
    }
    // 解析服务端返回结果
    NSError *jsonError;
    NSDictionary *result = [NSJSONSerialization JSONObjectWithData:data options:0 error:&jsonError];
    if (jsonError) {
        NSLog(@"解析返回失败: %@", jsonError);
        return;
    }
    NSLog(@"上传成功，Stripe文件ID: %@", result[@"fileId"]);
}];
[uploadTask resume];

3. 额外需要排查的细节 #

• 确认你的Stripe API密钥拥有file_upload权限，且stripe_account参数对应的是已创建的Connect账户。
• 检查文件规格：Stripe要求身份文件不超过10MB，图片分辨率需清晰可辨。
• 务必捕获并打印服务端的Stripe错误信息，错误详情里会明确告诉你是文件类型不合法、权限不足还是其他问题。

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