腾讯云短信SDK异常多因凭证、网络或配置错误，需检查SecretId/Key权限、SDK版本、日志开启、签名模板审核状态及号码格式等。
腾讯云短信 SDK 的 TencentCloudSDKException 总是抛出但没具体原因？
不是 SDK 本身坏了，大概率是凭证或网络配置没对上。C# SDK 默认不打印底层 HTTP 错误细节，TencentCloudSDKException 的 Message 字段常只显示“请求失败”，实际原因藏在 InnerException 或日志里。
- 启用 SDK 日志：在初始化客户端前加
System.Environment.SetEnvironmentVariable("TENCENTCLOUD_SDK_DEBUG", "1")，它会把原始请求/响应吐到控制台 - 检查
SecretId和SecretKey是否用了「API 密钥」而非「访问管理 > 用户 > API 密钥」里的旧密钥（新密钥需手动启用 COS/SMS 权限） - 确认你用的是
TencentCloud.Sms.V20190711命名空间，不是过时的V20180416—— 后者在 .NET Core 3.1+ 上会因 JSON 序列化差异静默失败
SmsClient.SendSms 返回成功但收不到短信？
成功只是代表腾讯云接收到了请求，并不保证送达。常见断点在签名、模板、号码三者校验链上。
- 签名必须已通过腾讯云控制台审核，且调用时传的是「签名内容」（如
"【腾讯云】"），不是签名 ID；模板 ID（TemplateId）要和签名绑定同一主体（个人/企业） - 测试手机号必须加国际区号，大陆号码写成
"+8613812345678"，少个+或86都会返回成功但丢弃 - 开发环境默认开启「国内短信调试开关」，此时只发给「短信控制台 > 开发配置 > 调试号码」列表里的号码，哪怕参数传了别的号也无效
怎么避免 SendSmsRequest 构造时字段错位或类型不匹配？
SDK 自动生成的类字段名和文档不完全一致，比如文档说「模板参数」叫 TemplateParamSet，实际 C# 类里是 TemplateParamSet（没错），但它的类型是 string[] 而非 string，传单个字符串会序列化为空数组。
-
SmsSdkAppId是应用 ID（形如1400789123），不是账号 APPID；SignName是签名名称（如"腾讯云"），不是签名 ID -
PhoneNumberSet必须是完整号码数组：new string[]{ "+8613812345678" }，传null或空数组会直接抛ArgumentException - 模板参数值不能含换行、制表符或控制字符，否则腾讯云静默截断——建议发送前用
value.Trim().Replace("\n", "").Replace("\t", "")
.NET Framework 和 .NET 6+ 的兼容性坑在哪？
官方 SDK 包 TencentCloudSDK.Net 已废弃，现在必须用 TencentCloud.Sms（带版本号后缀）。但不同运行时对证书验证、HTTP/2 的处理差异会导致偶发超时。
- .NET Framework 4.7.2+ 需确保系统已安装 KB4019276 补丁，否则 TLS 1.2 握手失败，错误表现为
WebException: The request was aborted: Could not create SSL/TLS secure channel - .NET 6+ 默认禁用不安全的重定向（307/308），而腾讯云某些地域接口会做内部跳转，需在创建
SmsClient前设置：AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", false) - 别用
HttpClient全局单例传给 SDK —— 它内部已管理连接池，外部传入反而干扰重试逻辑
最麻烦的其实是签名和模板的审核状态同步延迟，改完控制台配置后等 2–5 分钟再试，比反复改代码更省时间。
