设置parse_mode=MarkdownV2的PHP Telegram Bot无法推送至频道问题排查

问题肯定出在MarkdownV2的格式要求上——Telegram的MarkdownV2语法对特殊字符有强制转义要求，你当前的代码完全没处理这些转义，直接urlencode就发送，导致格式不符合规则被拒绝。

需要转义的特殊字符 #

MarkdownV2要求以下字符必须用反斜杠\转义：
_ * [ ] ( ) ~ ` > # + - = | { } . !

解决步骤 #

1. 先写一个转义函数，处理这些特殊字符
2. 对消息里需要用MarkdownV2格式化的部分（比如$obj->region、$obj->org，还有其他可能包含特殊字符的变量）进行转义
3. 再拼接消息文本，最后做urlencode发送

修改后的代码示例 #

// MarkdownV2特殊字符转义函数
function escapeMarkdownV2($text) {
    $specialChars = ['_', '*', '[', ']', '(', ')', '~', '`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!'];
    return str_replace($specialChars, array_map(function($char) {
        return "\\$char";
    }, $specialChars), $text);
}

$realurl = "https://$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]";
// 转义所有可能包含特殊字符的变量
$escapedRegion = escapeMarkdownV2($obj->region);
$escapedOrg = escapeMarkdownV2($obj->org);
$escapedRemoteAddr = escapeMarkdownV2($_SERVER['REMOTE_ADDR']);
$escapedReferrer = escapeMarkdownV2($_SERVER['HTTP_REFERER'] ?? '');
$escapedRealurl = escapeMarkdownV2($realurl);

// 拼接消息文本
$messageText = "{$escapedRealurl}\n**{$escapedRegion} - {$escapedOrg}** - {$escapedRemoteAddr} Referrer: {$escapedReferrer}";

// urlencode后发送
$encoded = urlencode($messageText);
file_get_contents($api_path."/sendmessage?chat_id=-152445&parse_mode=MarkdownV2&disable_web_page_preview=1&text=$encoded");

补充说明 #

为什么移除parse_mode就能正常发送？因为此时Telegram会把消息当成纯文本处理，不会解析任何格式语法，自然也就不会校验特殊字符的转义规则。但一旦开启MarkdownV2模式，就必须严格遵守它的格式规范，任何未转义的特殊字符都会导致消息发送失败。

内容的提问来源于stack exchange，提问作者Patoshi パトシ