Firebase Storage URL分享至Telegram时%2F被解码为斜杠导致链接失效的咨询

Telegram 的 tg://msg_url 唤起协议，在处理传入的url参数时，会自动对参数值执行一次内置URL解码。你当前只对原始Firebase URL做了一次encodeURIComponent编码，Telegram解码后，原本需要保留的路径编码字符%2F会被还原成斜杠/，直接破坏Firebase Storage要求的存储路径结构，最终导致访问404失效。

方案1：对传入链接做双重编码 #

这是改动成本最低的方案，不需要调整现有后端服务或文件存储结构。
因为Telegram会对传入参数做一次内置解码，只要把原始链接编码两次，Telegram解码一层后，剩下的编码状态刚好匹配原始Firebase URL的要求，不会错误解码%2F。
修改后的代码示例：

telegramOnClick = (episodeLink, episodeName) => {
    // 对链接做双重编码，抵消Telegram内置的一次解码逻辑
    const encodedShareUrl = encodeURIComponent(encodeURIComponent(episodeLink))
    // 分享文本同步编码，避免特殊字符打乱参数格式
    const encodedText = encodeURIComponent(episodeName)
    window.open(
        `tg://msg_url?url=${encodedShareUrl}&text=${encodedText}`, 
        "_blank"
    );
}

核心逻辑：原始URL中的%2F经过两次编码后会变成%252F，Telegram解码一层后，会还原成%2F——也就是Firebase能正确识别的标准编码路径，不会被错误替换成斜杠。

方案2：使用无特殊编码的短链接中转 #

如果双重编码在部分低版本Telegram上存在兼容问题，可以搭一层轻量跳转中转：

• 在你的后端增加一个简单的302跳转接口，把原始Firebase长URL存储后生成短ID，对应短链接格式比如https://your-domain.com/r/1001
• 分享时把这个短链接传给Telegram，短链接本身不含%2F这类容易被错误解码的特殊字符，Telegram怎么处理路径都不会破坏结构
• 用户点击短链接后，由后端直接302跳转到正确的Firebase资源地址
  这个方案可以完全绕开Telegram的自动解码逻辑，适配所有Telegram版本。

方案3：调整Firebase存储路径结构 #

对于新上传的文件，避免在文件存储路径中使用/做层级分隔（也就是你当前路径里的gs/分层），改用-或_连接成扁平的单段路径，比如把gs/BE24F9AE-xxx.jpeg改成gs_BE24F9AE-xxx.jpeg，这样即使Telegram把%2F解码成/，也不会出现路径分层错位的问题。这个方案适合新业务迭代使用，存量文件迁移成本较高，不适合作为优先选项。

改完代码后完整走一遍分享流程：

• 点击按钮唤起Telegram，选择接收对象发送内容
• 打开聊天窗口里生成的分享链接
• 确认浏览器地址栏的路径部分保留正确的%2F编码，不会出现斜杠替换后的错误路径

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