Google Cloud Bucket含重音文件名上传失败问题求助

结合你遇到的现象和测试结论，问题根源大概率是Google Cloud PHP SDK的upload方法在处理文件流时，会自动读取流的原始文件名元数据，而这个元数据的编码和你手动指定的name参数冲突，导致multipart请求构建失败。这里给你几个可行的解决方案：

1. 直接使用字符串上传（小文件推荐） #

如果你的文件体积不大，可以直接读取文件内容为字符串，完全绕过文件流的元数据问题：

$sha256 = hash_file("sha256", $filepath);
// 先确保文件路径是标准UTF-8编码
$utf8_filepath = mb_convert_encoding($filepath, 'UTF-8', mb_detect_encoding($filepath));

$content = file_get_contents($filepath);
$bucket->upload($content, [
    'name' => $utf8_filepath,
    'metadata' => [
        'metadata' => [
            'sha256' => $sha256,
        ]
    ]
]);

这种方式下所有参数都由你手动控制，不会触发SDK自动读取流文件名的逻辑。

2. 手动构建StorageObject再上传 #

绕过bucket->upload的自动流处理逻辑，先创建对象实例再上传，明确指定对象名称：

$sha256 = hash_file("sha256", $filepath);
$utf8_filepath = mb_convert_encoding($filepath, 'UTF-8', mb_detect_encoding($filepath));

// 先指定对象名称，再上传文件流
$object = $bucket->object($utf8_filepath);
$object->upload(fopen($filepath, 'rb'), [
    'metadata' => [
        'metadata' => [
            'sha256' => $sha256,
        ]
    ]
]);

这种方式会强制SDK使用你指定的文件名，不会再从流中自动读取原始文件名，避免编码冲突。

3. 修正文件路径编码，避免双重编码 #

你之前使用utf8_encode可能造成了双重编码问题——如果$filepath本身已经是UTF-8编码，utf8_encode会把它当成ISO-8859-1处理，反而破坏重音字符。正确的做法是先检测编码再转换：

$sha256 = hash_file("sha256", $filepath);
// 自动检测原始路径的编码（常见为ISO-8859-1或UTF-8）
$original_encoding = mb_detect_encoding($filepath, ['UTF-8', 'ISO-8859-1']);
$utf8_filepath = mb_convert_encoding($filepath, 'UTF-8', $original_encoding);

$bucket->upload(fopen($utf8_filepath, 'rb'), [
    'name' => $utf8_filepath,
    'metadata' => [
        'metadata' => [
            'sha256' => $sha256,
        ]
    ]
]);

同时用rb模式打开文件，避免Windows系统下的换行符转换问题，让流的处理更稳定。

关于你测试的奇怪现象的解释 #

当你用fopen($filepath, 'r')时，SDK会通过stream_get_meta_data获取流的uri属性（也就是原始文件路径），并将其用于multipart请求的构建。如果原始路径的编码不是UTF-8（比如含重音的ISO-8859-1字符），就会导致multipart body的编码混乱，触发Malformed multipart body错误。而换成fopen("testfile", 'r')时，这个文件名是纯ASCII，没有编码问题，所以即使指定name为编码后的路径，整个请求也能正常构建。

如果需要进一步调试，你可以开启Google Cloud SDK的日志功能，查看请求的具体内容，确认是哪个部分的编码出了问题。

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