Azure存储元数据能否用国际字符？非ASCII值设置问题咨询

首先，你的猜测完全正确——这个错误确实和非ASCII字符的编码处理直接相关。Azure Blob 存储的元数据是通过HTTP请求头传递的，而HTTP标准要求头字段的键和值只能包含ASCII字符。当你直接传入"/愛知県/bar"这类非ASCII字符串时，它会被自动转码为UTF-8字节的ASCII表示（也就是你看到的"/愛知県/bar"），这就导致存储的值和你预期的原始字符串不匹配，进而引发错误。

要正确设置非ASCII字符作为元数据值，你需要手动对值进行URL百分号编码，读取时再解码还原。下面是针对Go语言Azure SDK的具体实现步骤：

1. 编码非ASCII元数据值 #

使用Go标准库net/url中的QueryEscape方法对非ASCII字符串进行编码，确保它符合HTTP头的ASCII要求：

import (
    "net/url"
    "strings"
    "context"
    "github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
)

func main() {
    ctx := context.Background()
    // 假设你已经完成blobURL的初始化
    originalValue := "/愛知県/bar"
    // 对非ASCII值进行URL编码
    encodedValue := url.QueryEscape(originalValue)
    
    // 执行PutBlob请求，使用编码后的值作为元数据
    _, err := blobURL.PutBlob(
        ctx,
        strings.NewReader("Some text"),
        azblob.BlobHTTPHeaders{},
        azblob.Metadata{"Foo": encodedValue},
        azblob.BlobAccessConditions{},
    )
    if err != nil {
        // 根据业务需求处理错误
        panic(err)
    }
}

2. 读取时解码还原 #

当你从Blob存储中读取元数据时，需要对存储的编码值进行解码，才能得到原始的非ASCII字符串：

// 获取Blob属性（包含元数据）
props, err := blobURL.GetProperties(ctx, azblob.BlobAccessConditions{})
if err != nil {
    panic(err)
}

// 读取编码后的元数据值并解码
rawValue := props.Metadata["Foo"]
decodedValue, err := url.QueryUnescape(rawValue)
if err != nil {
    panic(err)
}
// decodedValue 此时就是原始的 "/愛知県/bar"

关键说明 #

• Azure Blob存储本身并不限制元数据值的内容，但HTTP传输层的ASCII要求必须遵守，所以编码是必要步骤。
• QueryEscape会对所有非ASCII字符以及特殊符号进行百分号编码，确保传输过程中不会出现乱码或解析错误。
• 如果你直接存储未编码的非ASCII值，Azure会自动将其转码为UTF-8字节的ASCII表示（即你看到的乱码），导致后续无法匹配原始字符串。

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