Twilio Task Queue Worker名称的具体限制要求咨询

核心问题原因 #

你遇到的故障根源是：当Worker的**唯一标识（Unique Name）**包含空格时，使用client:Mark H格式呼叫会触发Twilio的解析逻辑——空格会被识别为参数分隔符，导致H被截断，进而无法正确匹配Worker。注意：你设置的「Mark H」如果是友好名称（Friendly Name），本身不会影响路由，但如果误将其设为Unique Name就会出问题。

具体规则说明 #

• 大小写敏感性：Worker的Unique Name是大小写敏感的，markh和MarkH会被视为两个完全独立的Worker。
• 允许的字符：官方未在公开文档明确列出完整规则，但实测下来，建议仅使用字母（大小写均可）、数字、下划线_、连字符-，避免空格、特殊符号（如!@#$%^&*()）。带变音符号的Unicode字符（如é、ñ）无明确支持说明，使用后可能出现解析或匹配异常，不推荐。
• 长度限制：Worker的Unique Name最大长度为128字符，超出会导致创建失败。
• 友好名称 vs 唯一标识：友好名称（Friendly Name）仅用于控制台展示，可以包含空格、特殊字符；而参与路由逻辑的是Unique Name，必须符合上述字符规则，否则会触发路由解析错误。

快速修复方案 #

如果需要显示带空格的名称，可按以下方式设置：

• 将Worker的Unique Name设为无空格格式（如MarkH、Mark_H）
• 将Friendly Name设为「Mark H」用于控制台展示
• 呼叫时使用client:MarkH格式即可正常匹配

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