BOS客户端初始化必须严格匹配Bucket所在区域的endpoint，否则返回403或InvalidEndpoint错误；Go SDK需全局单例初始化、禁用重定向、传入完整STS凭证，并对大文件显式分片上传与清理。
bosclient 初始化必须匹配 Bucket 所在区域的 endpoint，否则会返回 403 Forbidden 或 InvalidEndpoint 错误。Beego 默认不内置 BOS SDK，需手动集成官方 @baiducloud/sdk（Node.js）或 Java/Go SDK（服务端渲染场景），但绝大多数 Beego 项目是 Go 编写的，所以重点看 Go SDK 集成。
Go SDK 初始化时 endpoint 写错导致连接失败
Beego 应用启动时若初始化 bosclient 失败，常见原因是 endpoint 与 Bucket 实际所在区域不一致。例如 Bucket 创建于广州（gz.bcebos.com），却用了北京的 bj.bcebos.com，请求会被拒绝。
-
endpoint必须严格对应 Bucket 所在区域，不能靠“就近猜测”——控制台里 Bucket 详情页明确写着“地域”，不是“可用区” - Go SDK 中
redirectdisabled: true不能设为false，否则重定向可能绕过你指定的endpoint，引发鉴权失败 - 若使用 STS 临时凭证，
sessionToken必须随ak/sk一并传入，缺一则报InvalidAccessKeyId
在 Beego Controller 中安全复用 bosclient 实例
不要每次 HTTP 请求都新建 bosclient，它内部维护连接池和签名器，频繁初始化会导致 goroutine 泄漏和 CPU 毛刺。应在 app.go 或 models/init.go 中全局初始化一次。
- 用
var BosClient *bos.BosClient声明包级变量，init 函数中完成构造 - 避免把
ak/sk硬编码进代码；从环境变量读取，如os.Getenv("BOS_AK") - 调用
PutObject时注意：Go SDK 的body参数是io.Reader，别直接传*bytes.Buffer而不重置 offset，否则第二次上传为空
上传大文件时触发分片上传但没处理 CompleteMultipartUpload
Beego 接收用户上传的文件（如 ctx.Input.RequestBody 或 ctx.GetFile）后，若直接丢给 bosclient.PutObject，5GB 以上会静默失败——SDK 不自动降级为分片上传，必须显式调用 InitiateMultipartUpload + UploadPart + CompleteMultipartUpload。
百度地图 RTOS SDK（mapsdk-rtos）应用层集成规范与代码生成。帮助应用开发者对接 mapsdk-rtos，开发类似 rtos-mac-simulator（mapAPP）的应用层，包含初始化鉴权、地图组件控制、覆盖物（Marker/Polyline）、检索路线、离线地图、导航、Canvas 适配层等能力。当用户提到：对接 RTOS 地图 SDK、集成 mapsdk-rtos、RTOS 地图初始化、MapComponentApi、AuthLicenseApi、SearchApi、NaviApi
- 简单上传只支持 ≤5GB；超过必须走分片流程，且
CompleteMultipartUpload是必须步骤，漏掉则产生“未完成分片（Incomplete Multipart Upload）”，长期占用配额并产生费用 - Beego 中建议对 >100MB 的文件启用分片：先
InitiateMultipartUpload获取uploadId，再按 5–10MB 切片循环UploadPart，最后CompleteMultipartUpload提交所有partETag - 务必捕获
CompleteMultipartUpload失败，并调用AbortMultipartUpload清理残留分片
Beego 日志与 BOS 错误码映射难定位问题
BOS 返回的错误信息藏在 SDK 的 err 里，不是 HTTP status code，而是封装后的 bce.BceError 结构体。直接 log.Println(err) 只能看到 “operation error BOS: PutObject …”，没实际线索。
- 必须类型断言：
if bceErr, ok := err.(bce.BceError); ok { log.Printf("BOS Code=%s, Message=%s", bceErr.StatusCode, bceErr.Message) } - 高频错误码：404 表示
BucketNotFound或ObjectNotFound；403 多为AccessDenied（权限不足）或InvalidAccessKeyId（AK/SK 过期或错误）；400 常见于InvalidObjectName（含非法字符如\、..） - 对象名（
objectName）禁止以/开头或结尾，也不能含空格或控制字符，Beego 接收参数后要strings.TrimSpace并校验
Beego 里集成 BOS 最容易被忽略的是：分片上传的清理闭环和错误结构体的解包。很多团队只测通了小文件上传，上线后大文件卡在 incomplete 状态，或者日志里全是泛化错误，排查时才发现没处理 AbortMultipartUpload 或没打印 bceErr.Code。
