Beego项目中直接调用腾讯云短信SDK易报错，因老版Beego（v1.x）多基于GOPATH模式，而tencentcloud-sdk-go依赖go mod，混用导致模块路径冲突、依赖解析失败及符号找不到；需强制GO111MODULE=on、指定兼容版本（如v1.0.714）并用replace或mod edit统一路径。
Beego 项目里直接调用腾讯云短信 SDK 是可行的，但必须绕过官方 SDK 的 Go module 冲突和 go mod 下载失败问题；否则会卡在 github.com/tencentcloud/tencentcloud-sdk-go 的依赖解析阶段。
为什么腾讯云官方 SDK 在 Beego 项目中容易报错
腾讯云 Go SDK（tencentcloud-sdk-go）默认使用 go mod 管理依赖，而老版本 Beego（尤其是 v1.x，如 github.com/astaxie/beego）大量项目仍基于 GO111MODULE=off 或 GOPATH 模式。两者混用会导致：
-
go get github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile失败，提示unknown revision v1.0.0或module declares its path as: github.com/tencentcloud/tencentcloud-sdk-go - 即使下载成功，
beego.Run()启动时 panic：找不到github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common的符号 - SDK 内部依赖的
golang.org/x/net等包被 Beego 的旧 vendor 或缓存污染
推荐做法：用 go get -u + 显式替换 replace
不改 Beego 版本的前提下，让腾讯云 SDK 正常工作，关键是强制统一模块路径与版本。操作顺序不能错：
- 确保
GO111MODULE=on（Beego v1.12+ 兼容，v2 已废弃，别用github.com/beego/beego/v2） - 执行：
go get -u github.com/tencentcloud/tencentcloud-sdk-go@v1.0.714（选已验证兼容的稳定版，v1.0.700+ 均可） - 在
go.mod文件末尾手动加一行：replace github.com/tencentcloud/tencentcloud-sdk-go => ./vendor/github.com/tencentcloud/tencentcloud-sdk-go（仅当项目有vendor时） - 若无
vendor，则删掉所有replace行，改用go mod edit -replace命令锁定路径：go mod edit -replace github.com/tencentcloud/tencentcloud-sdk-go=github.com/tencentcloud/tencentcloud-sdk-go@v1.0.714
Beego Controller 中发送短信的最小可用示例
不要在 init() 或全局变量里初始化腾讯云 client —— Beego 的 Controller 是每次请求新建实例，client 应复用。建议封装为单例或放在 models 目录下：
把一个已有 git 仓库装配成"TAPD 故事 → feature 分支 → PR → CNB AI 代码评审 → 合入 main → TAPD 故事自动回写 commit"的闭环工程挽具（harness）。适用于腾讯云 CNB（cnb.cool）+ TAPD 组合的团队。触发场景：(1) 用户要求把 git 仓库接入 CNB 和/或 TAPD；(2) 要求 commit/PR 自动关联 TAPD 故事；(3) 要求启用 CNB AI 代码评审（cnbcool/ai-review）；(
package models
import (
"github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"
"github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile"
sms "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/sms/v20210111"
)
var SmsClient *sms.Client
func InitSmsClient(secretId, secretKey, region string) error {
cpf := profile.NewClientProfile()
cpf.HttpProfile.ReqMethod = "POST"
cpf.HttpProfile.Endpoint = "sms.tencentcloudapi.com"
credential := common.NewCredential(secretId, secretKey)
client, err := sms.NewClient(credential, region, cpf)
if err != nil {
return err
}
SmsClient = client
return nil
}
在 controllers 中调用（注意错误处理和限流）：
func (c *SmsController) Post() {
phone := c.GetString("phone")
code := "123456" // 实际应由 rand + redis 生成并缓存
req := sms.NewSendSmsRequest()
req.PhoneNumberSet = []*string{common.StringPtr("+86" + phone)}
req.TemplateID = common.StringPtr("123456") // 你申请通过的模板 ID
req.SignName = common.StringPtr("你的签名名称")
req.TemplateParamSet = []*string{common.StringPtr(code)}
resp, err := models.SmsClient.SendSms(req)
if err != nil {
c.Data["json"] = map[string]interface{}{"err": err.Error()}
c.ServeJSON()
return
}
c.Data["json"] = map[string]interface{}{"result": resp.Response.SendStatusSet}
c.ServeJSON()
}
容易忽略的线上坑点
本地能发 ≠ 上线能用。这几个配置项不检查，90% 的失败都发生在这里：
- 腾讯云 API 密钥（
secretId/secretKey）必须是「子用户」密钥，且该子用户已绑定「SMS FullAccess」策略 —— 主账号密钥默认禁用 SMS 接口 -
region必须写成ap-guangzhou这种格式，不是gz或guangzhou；查可用区用ap-beijing、ap-shanghai等 - 短信模板审核状态必须是「已通过」，且模板内容与实际发送参数严格一致（比如模板含「{1}」，你就必须传
TemplateParamSet且长度 ≥1） - Beego 默认关闭 HTTPS 重定向，如果前端走
https://但后端没配 TLS，c.Ctx.Request.RemoteAddr可能拿不到真实 IP，影响风控校验
真正麻烦的从来不是代码怎么写，而是密钥权限、模板状态、区域拼写这三样——它们不出错时一切安静，一出错就是 401、403、InvalidParameter.TemplateContentMismatch，日志里却只打印“request failed”。
