更新密码找回uniapp

This commit is contained in:
hero920103 committed 2026-11-16 17:22:50 +08:00
1 parent 7f9a66da0f
commit 3fdda89833
1304 files changed
+3503 -26132

No files matched your search

-35
View File
@@ -14,17 +14,10 @@ import (
"time"
)
// =============================================================
// 微信小程序服务端 API
// 1. GET /sns/jscode2session code → openid / unionid / session_key
// 2. POST /wxa/business/getuserphonenumber phone_code → 手机号(需 access_token)
// =============================================================
const apiBase = "https://api.weixin.qq.com"
var httpClient = &http.Client{Timeout: 10 * time.Second}
// APIError 微信接口业务错误(HTTP 200 但 errcode 非 0)
type APIError struct {
API string
Code int
@@ -35,7 +28,6 @@ func (e *APIError) Error() string {
return fmt.Sprintf("%s 失败:errcode=%d errmsg=%s", e.API, e.Code, e.Msg)
}
// Explain 返回常见 errcode 的中文排查建议;未知错误码返回空串
func (e *APIError) Explain() string {
switch e.Code {
case 40029:
@@ -56,7 +48,6 @@ func (e *APIError) Explain() string {
return ""
}
// ExplainError 提取中文排查建议;无可用建议时返回 ("", false)
func ExplainError(err error) (string, bool) {
if ae, ok := err.(*APIError); ok {
if hint := ae.Explain(); hint != "" {
@@ -66,16 +57,12 @@ func ExplainError(err error) (string, bool) {
return "", false
}
// ============================ code 换 openid ============================
// Session jscode2session 返回结果
type Session struct {
OpenID string `json:"openid"`
UnionID string `json:"unionid"`
SessionKey string `json:"session_key"`
}
// Code2Session 用 wx.login / uni.login 拿到的 code 换 openid(+ unionid)
func Code2Session(cfg *Config, code string) (*Session, error) {
if cfg == nil || cfg.AppID == "" || cfg.AppSecret == "" {
return nil, ErrNotConfigured
@@ -99,17 +86,12 @@ func Code2Session(cfg *Config, code string) (*Session, error) {
return &Session{OpenID: resp.OpenID, UnionID: resp.UnionID, SessionKey: resp.SessionKey}, nil
}
// ============================ 手机号快速验证 ============================
// PhoneNumber getuserphonenumber 返回结果
type PhoneNumber struct {
PhoneNumber string `json:"phoneNumber"`
PurePhoneNumber string `json:"purePhoneNumber"`
CountryCode string `json:"countryCode"`
}
// GetPhoneNumber 用 getPhoneNumber 事件返回的动态 code 换真实手机号。
// 仅企业主体小程序可用;未开通该能力时微信返回 40226。
func GetPhoneNumber(cfg *Config, phoneCode string) (*PhoneNumber, error) {
if cfg == nil || cfg.AppID == "" || cfg.AppSecret == "" {
return nil, ErrNotConfigured
@@ -143,14 +125,6 @@ func GetPhoneNumber(cfg *Config, phoneCode string) (*PhoneNumber, error) {
}, nil
}
// ============================ 小程序码 ============================
// CreateUnlimitedQRCode 生成小程序码(wxa/getwxacodeunlimited,数量无限制),
// 返回图片 base64 data URL,可直接用于 <img src>。
//
// scene 会话标识,扫码后作为 options.scene 传给目标页面,1-32 个字符
// page 小程序页面路径(如 pages/register/confirm),必须已发布,不带前导 /
// envVersion release(正式版,默认)/ trial(体验版)/ develop(开发版)
func CreateUnlimitedQRCode(cfg *Config, scene, page, envVersion string) (string, error) {
if cfg == nil || cfg.AppID == "" || cfg.AppSecret == "" {
return "", ErrNotConfigured
@@ -177,8 +151,6 @@ func CreateUnlimitedQRCode(cfg *Config, scene, page, envVersion string) (string,
"env_version": envVersion,
"width": 280,
}
// 体验版 / 开发版下该页面尚未发布到正式版,必须关闭路径校验,
// 否则微信返回 40066 invalid url(正式版可保留默认校验)
if envVersion != "release" {
payload["check_path"] = false
}
@@ -187,7 +159,6 @@ func CreateUnlimitedQRCode(cfg *Config, scene, page, envVersion string) (string,
if err != nil {
return "", err
}
// 失败时微信仍返回 200,但响应体是 JSON 错误而非图片
if strings.HasPrefix(strings.TrimSpace(string(body)), "{") {
var resp struct {
ErrCode int `json:"errcode"`
@@ -202,8 +173,6 @@ func CreateUnlimitedQRCode(cfg *Config, scene, page, envVersion string) (string,
return "data:" + contentType + ";base64," + base64.StdEncoding.EncodeToString(body), nil
}
// ============================ access_token 缓存 ============================
type tokenEntry struct {
appID string
token string
@@ -216,7 +185,6 @@ var (
tokenMinTTL = 5 * time.Minute
)
// GetAccessToken 获取小程序 access_token(内存缓存,提前 5 分钟刷新)
func GetAccessToken(cfg *Config) (string, error) { return getAccessToken(cfg) }
func getAccessToken(cfg *Config) (string, error) {
@@ -252,8 +220,6 @@ func getAccessToken(cfg *Config) (string, error) {
return resp.AccessToken, nil
}
// ============================ HTTP 辅助 ============================
func httpGetJSON(api string, out interface{}) error {
resp, err := httpClient.Get(api)
if err != nil {
@@ -290,7 +256,6 @@ func httpPostJSON(api string, payload interface{}, out interface{}) error {
return nil
}
// httpPostBinary POST JSON 并返回原始响应体与 Content-Type(小程序码接口返回图片流)
func httpPostBinary(api string, payload interface{}) ([]byte, string, error) {
bs, err := json.Marshal(payload)
if err != nil {
+6 -32
View File
@@ -1,10 +1,3 @@
// Package wechatmini 微信小程序服务端能力:配置、code 换 openid、手机号快速验证。
//
// 与 services/wechatmp(公众号)分开:小程序走 sns/jscode2session 与
// wxa/business/getuserphonenumber,两者的 AppID / AppSecret 互不相通。
//
// 配置存储:多应用表 yz_platform_wechat_mini_app(docs/sql/create_wechat_mini_app.sql),
// 旧单行表 yz_platform_wechat_mini_config 仅作为未迁移部署的回退数据源。
package wechatmini
import (
@@ -18,22 +11,19 @@ import (
"server/services/wechatmp"
)
// Config 小程序运行配置(敏感字段已解密)
type Config struct {
ID uint64
Name string
AppID string
AppSecret string // 明文
QrcodeURL string // 小程序码图片地址(对外展示)
AppSecret string
QrcodeURL string
Enabled bool
AutoBind bool
Remark string
}
// ErrNotConfigured 未配置或未启用
var ErrNotConfigured = errors.New("微信小程序未配置或未启用")
// appFromRow 解密行数据为运行配置
func appFromRow(row models.WechatMiniApp) (*Config, error) {
cfg := &Config{
ID: row.ID,
@@ -54,8 +44,6 @@ func appFromRow(row models.WechatMiniApp) (*Config, error) {
return cfg, nil
}
// LoadConfig 读取小程序配置(多应用表第一条,敏感字段解密)。
// 新表无数据时回退旧单行表(未执行迁移 SQL 的存量部署);均未配置返回 ErrNotConfigured
func LoadConfig() (*Config, error) {
var rows []models.WechatMiniApp
_, err := models.Orm.QueryTable(new(models.WechatMiniApp)).
@@ -66,7 +54,6 @@ func LoadConfig() (*Config, error) {
return appFromRow(rows[0])
}
// 旧单行表回退
var legacy models.WechatMiniConfig
err = models.Orm.QueryTable(new(models.WechatMiniConfig)).OrderBy("id").One(&legacy)
if err != nil {
@@ -92,7 +79,6 @@ func LoadConfig() (*Config, error) {
return cfg, nil
}
// LoadEnabledConfig 读取并校验启用状态
func LoadEnabledConfig() (*Config, error) {
cfg, err := LoadConfig()
if err != nil {
@@ -104,8 +90,6 @@ func LoadEnabledConfig() (*Config, error) {
return cfg, nil
}
// LoadEnabledAppByAppID 按小程序 AppID 精确读取启用配置(多小程序场景,
// 认证端按客户端传入的 appid 选择对应应用)
func LoadEnabledAppByAppID(appID string) (*Config, error) {
appID = strings.TrimSpace(appID)
if appID == "" {
@@ -132,7 +116,6 @@ func LoadEnabledAppByAppID(appID string) (*Config, error) {
return cfg, nil
}
// ListApps 应用列表(软删除外,AppSecret 不回显)
func ListApps() ([]models.WechatMiniApp, error) {
var rows []models.WechatMiniApp
_, err := models.Orm.QueryTable(new(models.WechatMiniApp)).
@@ -142,7 +125,6 @@ func ListApps() ([]models.WechatMiniApp, error) {
return rows, err
}
// PublicApp 对外公布的小程序信息(供官网 / H5 等其他端展示二维码)
type PublicApp struct {
ID uint64 `json:"id"`
Name string `json:"name"`
@@ -150,7 +132,6 @@ type PublicApp struct {
QrcodeURL string `json:"qrcode_url"`
}
// ListEnabledApps 已启用的小程序(含二维码地址),供其他端公开读取
func ListEnabledApps() ([]PublicApp, error) {
var rows []models.WechatMiniApp
_, err := models.Orm.QueryTable(new(models.WechatMiniApp)).
@@ -173,19 +154,17 @@ func ListEnabledApps() ([]PublicApp, error) {
return list, nil
}
// SaveAppInput 保存应用入参(AppSecret 支持掩码表示不修改)
type SaveAppInput struct {
ID uint64
Name string
AppID string
AppSecret string // 掩码 / 空串 = 保持不变
QrcodeURL string // 空串 = 清空二维码
AppSecret string
QrcodeURL string
Enabled bool
AutoBind bool
Remark string
}
// SaveApp 新增/更新小程序应用(AppID 全局唯一,排除自身)
func SaveApp(in SaveAppInput) (uint64, error) {
appID := strings.TrimSpace(in.AppID)
if appID == "" {
@@ -206,7 +185,6 @@ func SaveApp(in SaveAppInput) (uint64, error) {
row = models.WechatMiniApp{CreateTime: now}
}
// AppID 唯一性校验(排除自身)
dupQ := models.Orm.QueryTable(new(models.WechatMiniApp)).
Filter("app_id", appID).
Filter("delete_time__isnull", true)
@@ -254,7 +232,6 @@ func SaveApp(in SaveAppInput) (uint64, error) {
return row.ID, nil
}
// DeleteApp 删除应用(软删并停用)
func DeleteApp(id uint64) error {
if id == 0 {
return errors.New("无效ID")
@@ -271,17 +248,14 @@ func DeleteApp(id uint64) error {
return err
}
// SaveInput 旧单行配置保存入参(AppSecret 支持掩码表示不修改)——兼容旧端点,
// 现写入新多应用表的第一行(无行时插入)
type SaveInput struct {
AppID string
AppSecret string // 掩码 / 空串 = 保持不变
AppSecret string
Enabled bool
AutoBind bool
Remark string
}
// SaveConfig 保存配置(兼容旧单行端点:写入新表第一行,不存在则创建)
func SaveConfig(in SaveInput) error {
var row models.WechatMiniApp
err := models.Orm.QueryTable(new(models.WechatMiniApp)).
@@ -308,7 +282,7 @@ func SaveConfig(in SaveInput) error {
Name: row.Name,
AppID: in.AppID,
AppSecret: in.AppSecret,
QrcodeURL: row.QrcodeURL, // 旧端点不改动二维码
QrcodeURL: row.QrcodeURL,
Enabled: in.Enabled,
AutoBind: in.AutoBind,
Remark: in.Remark,
+10 -61
View File
@@ -1,13 +1,3 @@
// Package wechatmini 微信小程序「消息推送」服务端能力。
//
// 对应小程序后台:开发管理 → 开发设置 → 消息推送。
// 后台需填写 URL / Token / EncodingAESKey / 加解密方式 / 数据格式,
// 微信会在保存时向 URL 发一次 GET 校验(signature + echostr),
// 保存成功后,用户向小程序客服发消息等事件会以 POST 推送到该 URL。
//
// 协议与公众号「服务器配置」一致(signature = sha1(sort(token,timestamp,nonce))),
// 复用 services/wechatmp 的签名与 AES 加解密原语,本文件补齐小程序侧
// 的多应用路由、JSON 数据格式与被动回复构造。
package wechatmini
import (
@@ -27,26 +17,22 @@ import (
beego "github.com/beego/beego/v2/server/web"
)
// 消息数据格式(小程序后台「数据格式」)
const (
DataFormatXML = "xml"
DataFormatJSON = "json"
)
// PushConfig 小程序消息推送运行配置(敏感字段已解密)
type PushConfig struct {
AppID string
Token string
AESKey string // 明文(43 位 EncodingAESKey)
EncryptMode string // plain / compatible / safe
DataFormat string // xml / json
ReplyText string // 客服消息自动回复文案(空 = 不自动回复)
AESKey string
EncryptMode string
DataFormat string
ReplyText string
}
// ErrPushNotConfigured 未配置消息推送
var ErrPushNotConfigured = errors.New("小程序消息推送未配置")
// pushConfigFromRow 读取行数据并解密 AESKey
func pushConfigFromRow(row models.WechatMiniApp) (*PushConfig, error) {
cfg := &PushConfig{
AppID: strings.TrimSpace(row.AppID),
@@ -71,8 +57,6 @@ func pushConfigFromRow(row models.WechatMiniApp) (*PushConfig, error) {
return cfg, nil
}
// LoadPushConfigs 读取全部已配置 Token 的小程序推送配置(未删除的记录)。
// 微信回调不携带 appid(明文模式下 ToUserName 即 appid),故按应用逐个匹配签名。
func LoadPushConfigs() ([]PushConfig, error) {
var rows []models.WechatMiniApp
_, err := models.Orm.QueryTable(new(models.WechatMiniApp)).
@@ -85,18 +69,17 @@ func LoadPushConfigs() ([]PushConfig, error) {
list := make([]PushConfig, 0, len(rows))
for _, r := range rows {
if strings.TrimSpace(r.Token) == "" {
continue // 未配置 Token 的应用不参与签名匹配
continue
}
cfg, cerr := pushConfigFromRow(r)
if cerr != nil {
continue // 解密失败的应用跳过,避免阻塞其它小程序
continue
}
list = append(list, *cfg)
}
return list, nil
}
// LoadPushConfigByAppID 按 appid 读取单个小程序的推送配置
func LoadPushConfigByAppID(appID string) (*PushConfig, error) {
appID = strings.TrimSpace(appID)
if appID == "" {
@@ -116,17 +99,15 @@ func LoadPushConfigByAppID(appID string) (*PushConfig, error) {
return pushConfigFromRow(row)
}
// SavePushConfigInput 保存推送配置入参(敏感字段支持掩码表示不修改)
type SavePushConfigInput struct {
AppID string
Token string
AESKey string // 掩码 / 空串 = 保持原值
AESKey string
EncryptMode string
DataFormat string
ReplyText string
}
// SavePushConfig 保存小程序消息推送配置
func SavePushConfig(in SavePushConfigInput) error {
appID := strings.TrimSpace(in.AppID)
if appID == "" {
@@ -188,9 +169,6 @@ func SavePushConfig(in SavePushConfigInput) error {
return err
}
// PushCallbackURL 小程序消息推送回调地址(填到小程序后台「消息推送 - URL」)。
// 优先读取 app.conf 的 wechat_mini_callback_base,其次回落 wechat_mp_callback_base
// / payment_callback_base(均为对外 API 域名)。
func PushCallbackURL() string {
base, _ := beego.AppConfig.String("wechat_mini_callback_base")
if strings.TrimSpace(base) == "" {
@@ -206,11 +184,8 @@ func PushCallbackURL() string {
return base + "/api/wechat/mini/callback"
}
// ============================ 随机 Token / EncodingAESKey ============================
const aesKeyAlphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
// randomString 从指定字符集随机取 n 个字符(crypto/rand 源)
func randomString(alphabet string, n int) string {
b := []byte(alphabet)
out := make([]byte, n)
@@ -218,7 +193,6 @@ func randomString(alphabet string, n int) string {
for i := range out {
idx, err := rand.Int(rand.Reader, max)
if err != nil {
// 随机源异常时退化为时间派生,保证不返回空串
out[i] = b[(time.Now().UnixNano()+int64(i))%int64(len(b))]
continue
}
@@ -227,39 +201,31 @@ func randomString(alphabet string, n int) string {
return string(out)
}
// GeneratePushToken 生成消息推送 Token(3-32 位字母数字)
func GeneratePushToken() string {
return randomString(aesKeyAlphabet, 24)
}
// GeneratePushAESKey 生成消息推送 EncodingAESKey(43 位字母数字)
// 43 位 base64 字符解码后为 32 字节,符合微信 AES-256-CBC 的密钥长度要求。
func GeneratePushAESKey() string {
return randomString(aesKeyAlphabet, 43)
}
// ============================ 消息解析 ============================
// PushMessage 小程序推送的消息 / 事件(已解密)
type PushMessage struct {
ToUserName string
FromUserName string
CreateTime int64
MsgType string // text / image / event ...
MsgType string
Content string
Event string // subscribe / unsubscribe / SCAN / CLICK ...
Event string
EventKey string
MsgID int64
Encrypt string // 兼容/安全模式外层携带的密文
Encrypt string
MsgSignature string
TimeStamp string
Nonce string
}
// IsEvent 是否为事件推送
func (m *PushMessage) IsEvent() bool { return strings.EqualFold(m.MsgType, "event") }
// pushXML 微信 XML 推送体
type pushXML struct {
XMLName struct{} `xml:"xml"`
ToUserName string `xml:"ToUserName"`
@@ -276,7 +242,6 @@ type pushXML struct {
Nonce string `xml:"Nonce"`
}
// pushJSON 微信 JSON 推送体
type pushJSON struct {
ToUserName string `json:"ToUserName"`
FromUserName string `json:"FromUserName"`
@@ -292,7 +257,6 @@ type pushJSON struct {
Nonce string `json:"Nonce"`
}
// ParsePushXML 解析 XML 推送体
func ParsePushXML(raw string) (*PushMessage, error) {
var p pushXML
if err := xml.Unmarshal([]byte(raw), &p); err != nil {
@@ -314,7 +278,6 @@ func ParsePushXML(raw string) (*PushMessage, error) {
}, nil
}
// ParsePushJSON 解析 JSON 推送体
func ParsePushJSON(raw string) (*PushMessage, error) {
var p pushJSON
if err := json.Unmarshal([]byte(raw), &p); err != nil {
@@ -336,7 +299,6 @@ func ParsePushJSON(raw string) (*PushMessage, error) {
}, nil
}
// DetectPushFormat 根据请求体判断数据格式(JSON 以 { 开头)
func DetectPushFormat(raw string) string {
trimmed := strings.TrimSpace(raw)
if strings.HasPrefix(trimmed, "{") {
@@ -345,9 +307,6 @@ func DetectPushFormat(raw string) string {
return DataFormatXML
}
// ============================ 被动回复构造 ============================
// BuildTextReply 构造文本被动回复(按数据格式输出 XML / JSON)
func BuildTextReply(format, toUser, fromUser, content string, timestamp int64) (string, error) {
if format == DataFormatJSON {
payload := map[string]interface{}{
@@ -369,7 +328,6 @@ func BuildTextReply(format, toUser, fromUser, content string, timestamp int64) (
esc.Replace(toUser), esc.Replace(fromUser), timestamp, esc.Replace(content)), nil
}
// BuildEncryptedReply 构造加密模式的被动回复(安全模式 / 兼容模式共用)
func BuildEncryptedReply(cfg *PushConfig, plainReply, timestamp, nonce, format string) (string, error) {
encrypt, err := wechatmp.EncryptMessage(cfg.AESKey, cfg.AppID, plainReply)
if err != nil {
@@ -394,9 +352,6 @@ func BuildEncryptedReply(cfg *PushConfig, plainReply, timestamp, nonce, format s
encrypt, sig, timestamp, nonce), nil
}
// ============================ 多应用匹配 ============================
// MatchPushConfigBySignature 按明文签名匹配小程序(sha1(sort(token,timestamp,nonce)))
func MatchPushConfigBySignature(cfgs []PushConfig, timestamp, nonce, signature string) (*PushConfig, bool) {
for i := range cfgs {
if wechatmp.CheckSignature(cfgs[i].Token, timestamp, nonce, signature) {
@@ -406,8 +361,6 @@ func MatchPushConfigBySignature(cfgs []PushConfig, timestamp, nonce, signature s
return nil, false
}
// MatchPushConfigByMsgSignature 按加密消息签名匹配小程序
// (sha1(sort(token,timestamp,nonce,encrypt)))
func MatchPushConfigByMsgSignature(cfgs []PushConfig, timestamp, nonce, encrypt, msgSignature string) (*PushConfig, bool) {
for i := range cfgs {
if wechatmp.CheckMsgSignature(cfgs[i].Token, timestamp, nonce, encrypt, msgSignature) {
@@ -417,16 +370,12 @@ func MatchPushConfigByMsgSignature(cfgs []PushConfig, timestamp, nonce, encrypt,
return nil, false
}
// DecryptPushMessage 用匹配的 AESKey 解密消息体(安全 / 兼容模式)
func DecryptPushMessage(cfg *PushConfig, encrypt string) (string, error) {
return wechatmp.DecryptMessage(cfg.AESKey, cfg.AppID, encrypt)
}
// PushHandler 消息处理钩子:返回给用户的被动回复文案,空串表示不回复。
// 默认按小程序配置的「客服自动回复文案」回复,可在业务层覆盖(如按关键字回复)。
var PushHandler func(cfg *PushConfig, msg *PushMessage) string
// HandlePushMessage 处理推送消息并返回被动回复文案
func HandlePushMessage(cfg *PushConfig, msg *PushMessage) string {
if PushHandler != nil {
return strings.TrimSpace(PushHandler(cfg, msg))
-2
View File
@@ -11,7 +11,6 @@ import (
"server/services/wechatmp"
)
// sign 复刻微信签名算法:sha1(sort(token, timestamp, nonce))
func sign(token, timestamp, nonce string) string {
arr := []string{token, timestamp, nonce}
sort.Strings(arr)
@@ -41,7 +40,6 @@ func TestGeneratePushSecrets(t *testing.T) {
}
}
// 生成的 EncodingAESKey 必须能被微信 AES-256-CBC 直接使用
func TestGeneratedAESKeyUsable(t *testing.T) {
key := GeneratePushAESKey()
plain := `<xml><ToUserName>wx123</ToUserName></xml>`
-25
View File
@@ -14,20 +14,9 @@ import (
"server/models"
)
// =============================================================
// 注册「账号注册」身份核验(小程序方案):
// 网页发起会话 → 展示小程序码(scene)→ 用户微信扫码进入小程序「注册确认」页 →
// 小程序端 wx.login 拿 code(可选手机号快速验证)调 confirm 上报 openid →
// 网页轮询到「已确认」后继续填写账号密码 → 第一步核验按 scene 核销取 openid,
// 注册完成后把该 openid 绑定到新身份(provider=wechat_mini),即可用小程序一键登录。
// =============================================================
const (
// DefaultRegisterTTL 注册会话有效期
DefaultRegisterTTL = 10 * time.Minute
// RegisterSceneLen 会话 scene 长度(微信限制 scene 不超过 32 字符)
RegisterSceneLen = 20
// registerSceneChars scene 字符集(只用小写字母与数字,避免扫码参数转义问题)
registerSceneChars = "abcdefghijklmnopqrstuvwxyz0123456789"
)
@@ -37,7 +26,6 @@ var (
ErrRegisterSceneUsed = errors.New("该二维码已完成核验,请重新获取")
)
// RegisterPagePath 小程序码指向的页面(app.conf:wechat_mini_register_page,默认 pages/register/confirm)
func RegisterPagePath() string {
page, _ := beego.AppConfig.String("wechat_mini_register_page")
page = strings.TrimPrefix(strings.TrimSpace(page), "/")
@@ -47,8 +35,6 @@ func RegisterPagePath() string {
return page
}
// RegisterEnvVersion 小程序码环境(app.conf:wechat_mini_register_env,默认 release;
// 未发布的小程序可填 trial 指向体验版、develop 指向开发版)
func RegisterEnvVersion() string {
env, _ := beego.AppConfig.String("wechat_mini_register_env")
env = strings.ToLower(strings.TrimSpace(env))
@@ -59,8 +45,6 @@ func RegisterEnvVersion() string {
return "release"
}
// StartRegisterVerify 创建注册会话并生成小程序码(返回 data URL 可直接展示)。
// 小程序未配置 / 小程序码生成失败时返回 err,由上层回退公众号或短信通道。
func StartRegisterVerify(ttl time.Duration) (scene, qrURL string, expireAt time.Time, err error) {
cfg, err := LoadEnabledConfig()
if err != nil {
@@ -92,7 +76,6 @@ func StartRegisterVerify(ttl time.Duration) (scene, qrURL string, expireAt time.
return scene, qrURL, expireAt, nil
}
// GetRegisterStatus 查询会话是否已被小程序端确认(过期惰性标记)
func GetRegisterStatus(scene string) (confirmed bool, expireAt time.Time, err error) {
row, err := loadRegister(scene)
if err != nil {
@@ -106,8 +89,6 @@ func GetRegisterStatus(scene string) (confirmed bool, expireAt time.Time, err er
return row.Status == models.MiniRegisterStatusConfirmed, expireAt, nil
}
// ConfirmRegister 小程序端确认注册:code → openid/unionid(可选手机号),CAS 标记已确认。
// appID 为空时取第一条启用的小程序配置;多小程序场景由小程序端传入自身 AppID。
func ConfirmRegister(scene, code, phoneCode, appID string) error {
scene = strings.TrimSpace(scene)
code = strings.TrimSpace(code)
@@ -123,7 +104,6 @@ func ConfirmRegister(scene, code, phoneCode, appID string) error {
logs.Warning("[wechat-mini] 注册确认 code 换取 openid 失败: %v", err)
return err
}
// 手机号快速验证为可选项:未开通 / code 失效时不阻断确认
mobile := ""
if strings.TrimSpace(phoneCode) != "" {
phone, perr := GetPhoneNumber(cfg, strings.TrimSpace(phoneCode))
@@ -166,7 +146,6 @@ func ConfirmRegister(scene, code, phoneCode, appID string) error {
return nil
}
// ConsumeRegister 核销会话并取出确认结果(一次性,供注册第一步核验使用)
func ConsumeRegister(scene string) (openid, unionid, mobile string, err error) {
row, err := loadRegister(scene)
if err != nil {
@@ -198,7 +177,6 @@ func ConsumeRegister(scene string) (openid, unionid, mobile string, err error) {
return row.OpenID, row.UnionID, row.Mobile, nil
}
// loadRegister 按 scene 读取会话
func loadRegister(scene string) (*models.AuthMiniRegister, error) {
scene = strings.TrimSpace(scene)
if scene == "" {
@@ -214,7 +192,6 @@ func loadRegister(scene string) (*models.AuthMiniRegister, error) {
return &row, nil
}
// markRegisterExpired 惰性标记过期
func markRegisterExpired(row *models.AuthMiniRegister) {
now := time.Now()
_, _ = models.Orm.QueryTable(new(models.AuthMiniRegister)).
@@ -223,7 +200,6 @@ func markRegisterExpired(row *models.AuthMiniRegister) {
Update(map[string]interface{}{"status": models.MiniRegisterStatusExpired, "update_time": now})
}
// loadConfigByAppID 按 AppID 选择小程序配置,缺省取第一条启用配置
func loadConfigByAppID(appID string) (*Config, error) {
if appID != "" {
return LoadEnabledAppByAppID(appID)
@@ -234,7 +210,6 @@ func loadConfigByAppID(appID string) (*Config, error) {
func randomScene(n int) string {
b := make([]byte, n)
if _, err := rand.Read(b); err != nil {
// 极低概率:退化为时间戳兜底,保证 scene 非空且合法
return "s" + strconv.FormatInt(time.Now().UnixNano(), 10)
}
for i := range b {
+9 -66
View File
@@ -13,36 +13,15 @@ import (
"github.com/beego/beego/v2/client/orm"
)
// =============================================================
// 小程序订阅消息 / 客服消息发送
//
// 订阅消息(用户主动授权后才能收到):
// POST /wxa/subscribe-message/send?access_token=xxx
// {"touser":"openid","template_id":"xxx","page":"pages/index/index",
// "data":{"thing1":{"value":"标题"},"time2":{"value":"2026-01-01 08:00"}}}
//
// 客服消息(用户在 48 小时内发过客服消息才能收到):
// POST /cgi-bin/message/custom/send?access_token=xxx
// {"touser":"openid","msgtype":"text","text":{"content":"..."}}
//
// 与「消息推送」(receive 方向)是两条不同的链路:
// 消息推送 = 用户发给你(服务器收)
// 订阅消息 = 你发给用户(用户收),需要用户在客户端授权
// =============================================================
// 订阅消息常见错误码
const (
ErrCodeUserRefuse = 43101 // 用户未订阅 / 拒绝订阅(一次性订阅用尽)
ErrCodeOpenIDInvalid = 40003 // openid 无效
ErrCodeTplParamError = 47003 // 模板参数不匹配(字段键或类型不对)
ErrCodeTokenInvalid = 40001 // access_token 无效或过期
ErrCodeUserRefuse = 43101
ErrCodeOpenIDInvalid = 40003
ErrCodeTplParamError = 47003
ErrCodeTokenInvalid = 40001
)
// ErrNoSubscribe 未找到可用的订阅授权
var ErrNoSubscribe = errors.New("用户未授权订阅消息")
// SendSubscribeMessage 发送订阅消息。
// data 为「微信字段键 → 文本值」,例如 {"thing1":"标题","time2":"2026-10-31 18:00"}
func SendSubscribeMessage(cfg *Config, openID, templateID, page string, data map[string]string) error {
if cfg == nil || cfg.AppID == "" || cfg.AppSecret == "" {
return ErrNotConfigured
@@ -90,8 +69,6 @@ func SendSubscribeMessage(cfg *Config, openID, templateID, page string, data map
return nil
}
// SendCustomerServiceText 发送客服消息(文本)。
// 前提:用户 48 小时内向小程序客服发过消息,否则微信返回 43101 / 45009。
func SendCustomerServiceText(cfg *Config, openID, content string) error {
if cfg == nil || cfg.AppID == "" || cfg.AppSecret == "" {
return ErrNotConfigured
@@ -124,7 +101,6 @@ func SendCustomerServiceText(cfg *Config, openID, content string) error {
return nil
}
// ExplainSubscribeError 订阅消息错误码的中文排查建议
func ExplainSubscribeError(err error) string {
var ae *APIError
if !errors.As(err, &ae) {
@@ -147,11 +123,6 @@ func ExplainSubscribeError(err error) string {
return ""
}
// =============================================================
// 模板配置(平台端维护)
// =============================================================
// TemplateInput 保存模板入参
type TemplateInput struct {
ID uint64
AppID string
@@ -159,12 +130,11 @@ type TemplateInput struct {
TemplateID string
Title string
Page string
Fields string // JSON 字符串
Fields string
Enabled bool
Remark string
}
// ListTemplates 查询某小程序的模板列表
func ListTemplates(appID string) ([]models.WechatMiniTemplate, error) {
var rows []models.WechatMiniTemplate
q := models.Orm.QueryTable(new(models.WechatMiniTemplate)).
@@ -178,7 +148,6 @@ func ListTemplates(appID string) ([]models.WechatMiniTemplate, error) {
return rows, err
}
// GetTemplateByCode 按场景码取模板
func GetTemplateByCode(appID, code string) (*models.WechatMiniTemplate, error) {
var row models.WechatMiniTemplate
err := models.Orm.QueryTable(new(models.WechatMiniTemplate)).
@@ -192,7 +161,6 @@ func GetTemplateByCode(appID, code string) (*models.WechatMiniTemplate, error) {
return &row, nil
}
// SaveTemplate 保存模板
func SaveTemplate(in TemplateInput) error {
appID := strings.TrimSpace(in.AppID)
code := strings.TrimSpace(in.Code)
@@ -248,7 +216,6 @@ func SaveTemplate(in TemplateInput) error {
return err
}
// DeleteTemplate 软删模板
func DeleteTemplate(id uint64) error {
if id == 0 {
return errors.New("无效ID")
@@ -260,11 +227,6 @@ func DeleteTemplate(id uint64) error {
return err
}
// =============================================================
// 订阅授权记录
// =============================================================
// GrantSubscribe 记录用户授权(一次性订阅:每次授权 +1 次发送机会)
func GrantSubscribe(identityID uint64, appID string, templateIDs []string) error {
if identityID == 0 {
return errors.New("未登录")
@@ -306,7 +268,6 @@ func GrantSubscribe(identityID uint64, appID string, templateIDs []string) error
return nil
}
// SubscribeRemain 查询剩余可发送次数
func SubscribeRemain(identityID uint64, appID, templateID string) int {
var row models.WechatMiniSubscribe
err := models.Orm.QueryTable(new(models.WechatMiniSubscribe)).
@@ -320,7 +281,6 @@ func SubscribeRemain(identityID uint64, appID, templateID string) int {
return row.Remain
}
// consumeSubscribe 消耗一次发送机会(成功发送后调用)
func consumeSubscribe(identityID uint64, appID, templateID string) {
now := time.Now()
models.Orm.QueryTable(new(models.WechatMiniSubscribe)).
@@ -331,11 +291,6 @@ func consumeSubscribe(identityID uint64, appID, templateID string) {
Update(map[string]interface{}{"remain": orm.ColValue(orm.ColMinus, 1), "update_time": now})
}
// =============================================================
// 推送编排
// =============================================================
// MiniOpenIDByIdentity 取身份绑定的小程序 openid(未绑定返回空串)
func MiniOpenIDByIdentity(identityID uint64) string {
if identityID == 0 {
return ""
@@ -351,20 +306,16 @@ func MiniOpenIDByIdentity(identityID uint64) string {
return strings.TrimSpace(row.OpenID)
}
// PushResult 一次推送的结果汇总
type PushResult struct {
Sent int // 成功条数
Skipped int // 跳过(未授权 / 未绑定 / 无模板)
Errors []error // 失败原因
Sent int
Skipped int
Errors []error
}
// PushSubscribe 按场景向某个身份推送订阅消息。
// vars 为语义变量(如 title / content / time),按模板配置的字段映射填入微信字段。
func PushSubscribe(scene string, identityID uint64, vars map[string]string) PushResult {
return pushSubscribe(scene, "", identityID, vars)
}
// PushSubscribeToTenantUser 按场景向租户用户推送(appID 为空表示所有启用的小程序)
func PushSubscribeToTenantUser(tenantUserID uint64, scene, appID string, vars map[string]string) PushResult {
identityID, err := tenantUserIdentityID(tenantUserID)
if err != nil || identityID == 0 {
@@ -414,7 +365,6 @@ func pushSubscribe(scene, appIDFilter string, identityID uint64, vars map[string
data := buildTemplateData(tpl.Fields, vars)
serr := SendSubscribeMessage(cfg, openID, tpl.TemplateID, tpl.Page, data)
if serr != nil {
// 用户拒绝 / 授权用尽:清零机会,避免反复调接口
if ae, ok := serr.(*APIError); ok && ae.Code == ErrCodeUserRefuse {
models.Orm.QueryTable(new(models.WechatMiniSubscribe)).
Filter("identity_id", identityID).
@@ -431,8 +381,6 @@ func pushSubscribe(scene, appIDFilter string, identityID uint64, vars map[string
return res
}
// buildTemplateData 按字段映射组装微信模板数据
// mapping 形如 {"thing1":"title","phrase2":"content"}:微信字段键 → 语义变量名
func buildTemplateData(mapping string, vars map[string]string) map[string]string {
out := make(map[string]string)
m := map[string]string{}
@@ -442,12 +390,10 @@ func buildTemplateData(mapping string, vars map[string]string) map[string]string
for field, semantic := range m {
val, ok := vars[semantic]
if !ok {
// 映射里的变量没有值时给个占位,避免微信报字段缺失
val = "-"
}
out[field] = val
}
// 变量表里多出来的键也直接按微信字段名填(允许不配映射直接用 thing1 这种键)
for k, v := range vars {
if _, exists := out[k]; !exists {
out[k] = v
@@ -456,7 +402,6 @@ func buildTemplateData(mapping string, vars map[string]string) map[string]string
return out
}
// PushTenantNotice 推送站内通知到小程序(按租户用户)
func PushTenantNotice(tenantUserID uint64, title, content string) PushResult {
vars := map[string]string{
"title": title,
@@ -466,12 +411,10 @@ func PushTenantNotice(tenantUserID uint64, title, content string) PushResult {
return PushSubscribeToTenantUser(tenantUserID, SceneNotice, "", vars)
}
// 场景码
const (
SceneNotice = "notice" // 站内通知 / 审批待办等通用提醒
SceneNotice = "notice"
)
// tenantUserIdentityID 租户用户 ID → 身份 ID(yz_system_tenant_user.uid)
func tenantUserIdentityID(tenantUserID uint64) (uint64, error) {
if tenantUserID == 0 {
return 0, errors.New("无效用户")