适配Cosmos DB ID的合法编码方案：替换非法字符咨询

核心诉求梳理 #

你需要的是一种能处理Cosmos DB ID非法字符（比如/）的编码方式：不能用URL编码（%会触发检索异常），不能用Base64（可读性差），也不能简单字符替换（怕原ID存在冲突）。

推荐方案：转义式编码 #

具体规则 #

针对Cosmos DB明确禁止的4个字符（/、\、?、#），采用「下划线+对应ASCII十六进制码」的组合替换：

• / → _2F
• \ → _5C
• ? → _3F
• # → _23

如果担心原ID中存在_+十六进制的组合引发冲突，可以先把原ID里的_转义为_5F，解码时再反向还原。

方案优势 #

1. 无检索风险：下划线和十六进制字符都是Cosmos DB ID允许的合法字符，不会像%那样出现部分检索失败的问题
2. 冲突概率极低：原ID恰好出现_2F这类组合的场景极少，加上对_的二次转义，可彻底避免冲突
3. 可读性强：看到_2F就能直接对应到原字符/，不需要像Base64那样解码才能识别
4. 转换逻辑可靠：编码和解码规则清晰，不会出现歧义或还原错误

示例代码（C#） #

// 编码ID，处理非法字符及下划线冲突
public string EncodeCosmosId(string originalId)
{
    // 先转义下划线，避免后续转义规则冲突
    originalId = originalId.Replace("_", "_5F");
    
    // 转义Cosmos DB非法字符
    var charMapping = new Dictionary<char, string>
    {
        {'/', "_2F"},
        {'\\', "_5C"},
        {'?', "_3F"},
        {'#', "_23"}
    };
    
    foreach (var pair in charMapping)
    {
        originalId = originalId.Replace(pair.Key.ToString(), pair.Value);
    }
    return originalId;
}

// 解码ID，还原原始字符
public string DecodeCosmosId(string encodedId)
{
    // 先还原非法字符
    var stringMapping = new Dictionary<string, char>
    {
        {"_2F", '/'},
        {"_5C", '\\'},
        {"_3F", '?'},
        {"_23", '#'}
    };
    
    foreach (var pair in stringMapping)
    {
        encodedId = encodedId.Replace(pair.Key, pair.Value.ToString());
    }
    
    // 再还原下划线
    encodedId = encodedId.Replace("_5F", "_");
    return encodedId;
}

额外提醒 #

• 测试时需覆盖所有非法字符场景，确保编码解码后与原ID完全一致
• 其他语言实现逻辑通用，仅需调整字符串替换的语法即可

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