LibVLCSharp：密码含@时如何配置媒体选项正常播放RTSP流？

核心问题根因 #

调用media.AddOption接口的libvlc类媒体播放框架，对RTSP认证信息的处理存在两套独立逻辑，特殊字符转义规则不统一，是造成认证失败的核心原因：

• URL内嵌认证的处理逻辑：严格遵循RFC3986标准对账号密码段做自动解码，可正确识别转义后的特殊字符
• 独立Option传认证的处理逻辑：不会对传入的:rtsp-pwd/:rtsp-user参数值做自动解码，且老版本框架会把参数值内的@字符误识别为URL主机段分隔符，直接截断参数内容

可稳定运行的适配方案 #

• 全版本兼容的推荐方案：URL内嵌转义认证
  完全不依赖独立的认证Option参数，直接将账号密码段按URL编码规则拼接到RTSP地址中——把密码内的@字符做标准URL转义为%40，最终地址格式为：
  rtsp://username:pass%40word@domain:port
  这种方式走框架原生URL解析逻辑，不存在版本兼容问题，也是经过实际验证可稳定拉取流的实现方式，不需要额外补充其他认证配置。
• 仅高版本支持的方案：独立Option传认证
  如果必须使用独立Option传递认证信息，需满足以下要求：
  1. 依赖的libvlc框架版本为3.0.18及以上，已修复参数特殊字符截断的已知bug
  2. 基础RTSP URL拼接为不带账号密码的纯地址形式：rtsp://domain:port
  3. 传参时直接填写原始未转义的账号、密码值，不要手动提前做URL转义，写法示例：
     media.AddOption(":rtsp-user=username")
media.AddOption(":rtsp-pwd=pass@word")

认证失败的错误配置示例 #

以下两种写法在全版本框架下均无法正常认证，属于无效配置：

• 手动转义后通过Option传参：media.AddOption(":rtsp-pwd=pass%40word")，框架不会对该参数值做自动解码，实际传给RTSP服务端的密码为字符串pass%40word，与真实密码不匹配
• 老版本框架下直接传未转义密码：老版本会把参数值内的@识别为分隔符，实际传给服务端的密码会被截断为pass，认证必然失败

排坑提醒：不要尝试对密码做多层嵌套URL编码（如将pass@word转义为pass%2540word），该方式在不同版本框架上的自动解码次数不统一，兼容性极差，极易出现跨版本运行失效的问题。

内容的提问来源于stack exchange，提问作者Rafael F.