Files
go-sms-V2/cmd/gateway/main.go
T

403 lines
17 KiB
Go

// go-sms-gateway:go-sms 接入网关服务入口(app 启动器装配 + v1 业务路由挂载)。
package main
import (
"context"
"time"
"github.com/IBM/sarama"
"github.com/gin-gonic/gin"
"go.uber.org/zap"
v1 "go-sms/internal/api/http/v1"
"go-sms/internal/app"
"go-sms/internal/middleware"
"go-sms/internal/pkg/casbin"
"go-sms/internal/pkg/cronx"
jwtpkg "go-sms/internal/pkg/jwt"
"go-sms/internal/pkg/metrics"
"go-sms/internal/pkg/queue"
"go-sms/internal/pkg/storage"
cmppproto "go-sms/internal/protocol/cmpp"
smppproto "go-sms/internal/protocol/smpp"
"go-sms/internal/service/access"
"go-sms/internal/service/account"
"go-sms/internal/service/audit"
"go-sms/internal/service/auth"
"go-sms/internal/service/balance"
"go-sms/internal/service/channel"
"go-sms/internal/service/interceptor"
"go-sms/internal/service/openapi"
"go-sms/internal/service/report"
"go-sms/internal/service/router"
"go-sms/internal/service/send"
"go-sms/internal/service/template"
"go-sms/internal/service/uplink"
"go-sms/internal/util"
)
// 构建时通过 -ldflags -X 注入(见 Dockerfile / Makefile)。
var (
version = "dev"
commit = "none"
)
func main() {
app.Main(app.Options{
ServiceName: "go-sms-gateway",
Version: version,
Commit: commit,
RegisterRoutes: func(r *gin.Engine, a *app.App) {
db := a.DB()
if db == nil {
return
}
cfg := a.Config()
svc := account.NewService(db, 0)
// Casbin 权限引擎(Day 25:开户/改角色自动同步 casbin_rule;
// 创建失败降级为 nil → 不挂细粒度校验,鉴权仍由 JWT 兜底)
var perm middleware.PermissionChecker
if enforcer, err := casbin.New(db); err != nil {
a.Lg().Warn("casbin_init_failed_degraded", zap.Error(err))
} else {
svc.WithEnforcer(enforcer)
perm = middleware.CasbinChecker(enforcer)
}
// 认证服务(Day 24):黑名单/失败计数优先 Redis,降级内存实现
var store auth.TokenStore
rc := a.Redis()
if rc != nil {
store = auth.NewRedisTokenStore(rc)
}
authSvc := auth.NewService(db, jwtpkg.NewManager(cfg.JWT.Secret, cfg.JWT.TTL), store)
// Day 42:发送拦截器链——黑名单三级(Redis 缓存)/频次滑窗(Redis ZSet)/
// 签名/退订/地区;命中经 DBRecorder 落 send_block_log;/send/precheck 与 Day46 提交共用。
var ichain *interceptor.Chain
if rc != nil {
ichain = interceptor.NewDefaultChain(db, rc,
interceptor.NewDBRecorder(db),
interceptor.Options{FreqStore: interceptor.NewRedisFreqStore(rc)})
} else {
ichain = interceptor.NewDefaultChain(db, nil,
interceptor.NewDBRecorder(db), interceptor.Options{})
}
rg := r.Group("/api/v1")
warnSvc := account.NewWarningService(db, nil)
auditSvc := audit.NewService(db)
reviewSvc := audit.NewReviewService(db) // Day 43:消息审核(审核中心+D19 定时任务)
// Day 43 修复循环:最小提交链(雪花明细 ID;WorkerID 单机固定 1,多副本 Day47 ETCD 抢注)。
sf, sfErr := util.NewSnowflake(1)
if sfErr != nil {
panic("snowflake init: " + sfErr.Error())
}
// Day 48:全流程状态机——拦截链(Day42)+sms-submit 统一出口(ProducerSink,
// 替代 openapi 自投,预扣/拦截退费/审核拒绝退费在 SubmitService 内闭环)。
// Kafka 降级(producer=nil)不注入 sink:发送由 ReclaimScanner DB 认领兜底。
pipelineOpts := []send.SubmitOption{send.WithInterceptorChain(ichain)}
if p := a.Producer(); p != nil {
pipelineOpts = append(pipelineOpts,
send.WithEventSink(send.ProducerSink{P: p, Source: "submit"}))
a.Lg().Info("submit_pipeline_ready",
zap.Bool("interceptor", ichain != nil), zap.String("sink", "sms-submit"))
// Day55:go_sms_kafka_lag 指标导出(Day53 告警挂账清偿)——只读 LagReader
// 与 consumer 同组采样 submit topic lag,15s 周期(对齐 Prometheus 抓取);
// 采样失败保留上次值+首次 Warn(链路抖动不抹零,防「lag 消失」假象)。
lagGroup := cfg.Kafka.Consumer.GroupID
if lagGroup == "" {
lagGroup = "go-sms-consumer"
}
lagTopic := cfg.Kafka.Topics["submit"]
if lagTopic == "" {
lagTopic = queue.TopicSubmit
}
if lagR, lagErr := queue.NewLagReader(cfg.Kafka.Brokers, lagGroup, a.Lg()); lagErr != nil {
a.Lg().Warn("kafka_lag_reader_disabled", zap.Error(lagErr))
} else {
lagCtx, stopLag := context.WithCancel(context.Background())
go func() {
tk := time.NewTicker(15 * time.Second)
defer tk.Stop()
var warned bool
for {
select {
case <-lagCtx.Done():
return
case <-tk.C:
v, err := lagR.Total(lagCtx, []string{lagTopic})
if err != nil {
if !warned {
a.Lg().Warn("kafka_lag_sample_failed", zap.Error(err))
warned = true
}
continue
}
warned = false
metrics.KafkaLag.WithLabelValues(lagTopic).Set(float64(v))
}
}
}()
a.OnShutdown(func() { stopLag(); _ = lagR.Close() })
}
} else {
a.Lg().Warn("submit_pipeline_kafka_disabled",
zap.String("fallback", "reclaim_scanner_db_claim"))
}
// Day54 R1:资金预扣 Store(评审 docs/review/r1-balance.md)——
// mode=redis:Lua 原子扣+异步流水批写+对账覆写+故障单次回退 MySQL;
// env GOSMS_BALANCE_MODE/热配置 15s 轮询切换(默认 mysql 行锁原路径)。
balStore := balance.Store(balance.NewMySQLStore(db))
if balance.NormalizeMode(cfg.Balance.Mode) == balance.ModeRedis {
if rc != nil {
rs := balance.NewRedisStore(rc, db, sf, a.Lg(), balance.RedisOptions{})
fb := balance.NewFallbackStore(rs, balance.NewMySQLStore(db), a.Lg())
balStore = fb
rec := balance.NewReconciler(rc, db, rs, a.Lg(),
balance.ReconcilerOptions{Interval: cfg.Balance.ReconcileInterval})
balCtx, stopBal := context.WithCancel(context.Background())
go rec.Run(balCtx)
go balance.RunModeWatcher(balCtx, fb,
func() string { return a.Config().Balance.Mode })
a.OnShutdown(func() { stopBal(); rs.Close() })
a.Lg().Info("balance_redis_mode_ready",
zap.String("reconcile_interval", cfg.Balance.ReconcileInterval.String()),
zap.String("fallback", "mysql_row_lock"),
zap.String("diff_metric", "go_sms_balance_reconcile_diff"))
} else {
metrics.BalanceMode.Set(0)
a.Lg().Warn("balance_redis_mode_no_redis_fallback_mysql",
zap.String("note", "Redis 未装配,预扣走 MySQL 行锁原路径"))
}
}
pipelineOpts = append(pipelineOpts, send.WithBalanceStore(balStore))
submitSvc := send.NewSubmitService(db, sf, reviewSvc, pipelineOpts...)
// Day 44:MinIO 对象存储(号码文件);初始化失败降级 nil → /files/numbers/import 不注册。
var fileImportSvc *send.FileImportService
if mo, merr := storage.NewMinIO(context.Background(),
cfg.MinIO.Endpoint, cfg.MinIO.AccessKey, cfg.MinIO.SecretKey, cfg.MinIO.Bucket, cfg.MinIO.UseSSL); merr != nil {
a.Lg().Warn("minio_init_failed_file_import_disabled", zap.Error(merr))
} else {
fileImportSvc = send.NewFileImportService(mo, sf)
a.Lg().Info("minio_storage_ready", zap.String("bucket", cfg.MinIO.Bucket))
}
rt := router.NewRouter(db)
chSvc := channel.NewService(db) // Day 40:提取变量——链路引导/告警 cron/优雅停机接线
// Day 49:上行域——码号分配缓存(30s 刷新)+Deliver MO→分配→落库
// message_uplink→投 sms-up(消费者进程 15 天窗口匹配)。producer 降级
// nil 时仅落库;nil 指针不注入接口(空接口调用 panic)。
upAsg := uplink.NewAssigner(db)
var upProd uplink.Producer
if p := a.Producer(); p != nil {
upProd = p
}
chSvc.SetUplinkSink(uplink.NewService(db, upAsg, upProd))
upCtx, stopUpAsg := context.WithCancel(context.Background())
go upAsg.Start(upCtx, uplink.DefaultReloadEvery)
a.OnShutdown(stopUpAsg)
// Day 56:回执域——状态报告经 sms-report 投递(消费者进程归一化+
// 段级配对回写 detail 终态);producer 降级 nil 时不注入(仅日志/环形)。
if p := a.Producer(); p != nil {
chSvc.SetReportSink(report.NewSink(p))
}
// 阶段5收尾(D28 挂账清偿):回执重推+手动配对服务(终态链复用
// consumer 同款 finalizeDetail 单一实现;计费走 balStore 同一 Store)。
pairSvc := report.NewPairService(db, report.NewBilling(db, balStore), sf)
if p := a.Producer(); p != nil {
pairSvc = pairSvc.WithPushSink(&report.ProducerPushSink{P: p})
}
v1.Register(rg, v1.Deps{
Account: svc,
Warning: warnSvc,
Audit: auditSvc,
Review: reviewSvc, // Day 43
Submit: submitSvc, // Day 43 修复循环:/send/submit
FileImport: fileImportSvc, // Day 44:/files/numbers/import(MinIO)
Channel: chSvc,
Upstream: channel.NewUpstreamService(db), // Day 41(清债③)
Template: template.NewService(db), // Day 41:模板/预估
Interceptor: ichain, // Day 42:发送拦截器链
Router: rt, // Day 38:导流规则管理端点
AuthSvc: authSvc,
// JWT 鉴权 + 登出黑名单 + 账号状态校验(Day 24)
Auth: middleware.AuthJWTWithRevocation(cfg.JWT.Secret, authSvc.Revoked, svc.CheckEnabled),
Perm: perm,
// Day 53(runbook P0):/fe-errors 落库裸 DB + /alerts/sink AM webhook 留痕
DB: db,
// Day 56:错误码维护(/system/error-codes 增改停用)
ErrorCode: report.NewErrorCodeService(db),
Logger: a.Lg(),
// Day 62:CMPP 接入系统默认(api-config 的 cmpp_access 交付块数据源)
CMPPCfg: &cfg.Server.CMPP,
// 阶段5收尾(D28):/record/repush 域四端点
Pair: pairSvc,
})
// Day68:运营总览汇总刷新(回补 30 天+60s ticker 增量 UPSERT stats_daily;
// 幂等多实例无害,详见 stats_handler.go StartStatsRefresher)。
v1.StartStatsRefresher(db, a.Lg())
// Day 46:外部 HTTP API 提交(SMS_HTTP_1.6;/sms/api 独立协议域,MD5 验签+
// 双桶限流:全局 IP 桶(静态配置)+账号桶(动态 speed_limit);
// Kafka producer 未装配时降级仅落库,发送由定时调度器 DB 认领兜底)。
openapiSvc := openapi.NewService(db, submitSvc, a.Producer())
v1.RegisterOpenAPI(r, v1.OpenAPIDeps{
Auth: openapi.NewAuthenticator(db),
Svc: openapiSvc,
Redis: rc, // *cache.Client(嵌入 redis.UniversalClient);nil=限流降级放行
Global: middleware.RateLimitConfig{
Capacity: cfg.RateLimit.Capacity,
Rate: cfg.RateLimit.RatePerSec,
},
})
a.Lg().Info("openapi_http_submit_ready",
zap.String("group", "/sms/api"), zap.Bool("kafka", a.Producer() != nil))
// P1 修复(09-27 通道超限报障):gateway 不再引导常驻链路。
// 双进程架构下发域归 consumer,gateway 的通道池纯占通道账号连接额度
// (通道 331004 上限 20:gateway 50+consumer 51=101 条 → 22:01 通道拒新/22:06 批量踢)。
// 通道池由 consumer 独占 conn_count(=20)。
a.OnShutdown(chSvc.Close) // Day 40:通道日志冲刷落库
// Day 45:定时调度器(ZSet 唤醒索引+DB 原子认领+router 选路链路分发;
// Redis 缺失降级纯 DB 扫描;随优雅停机拆除)。
// Day 47:分发链路注入合包聚合器(5s/1000 双阈值;同通道同内容合批,
// CMPP 单包≤100 号切包,提交调用次数降至 ~1/100)。
var timerQ send.TaskQueue
if rc != nil {
timerQ = send.NewRedisZSetQueue(rc, send.QueueKey())
}
aggregator := send.NewSubmitAggregator(chSvc,
send.DefaultAggrWindow, send.DefaultAggrMaxBatch).WithDB(db) // Day56 seg 配对登记(装配遗漏修复)
aggCtx, stopAgg := context.WithCancel(context.Background())
go aggregator.Run(aggCtx)
a.OnShutdown(func() { stopAgg(); aggregator.FlushAll() })
timerCtx, stopTimer := context.WithCancel(context.Background())
go send.NewTimerScheduler(db, timerQ,
send.NewChannelDispatcher(db, rt, chSvc, aggregator)).Run(timerCtx)
a.OnShutdown(stopTimer)
a.Lg().Info("timer_scheduler_started",
zap.String("interval", "5s"), zap.Bool("redis_queue", timerQ != nil),
zap.String("aggregator", "5s/1000"))
// Day 47:CMPP/SMPP 客户接入(TCP 服务端;鉴权=账号体系+ApiSecret 共享密钥,
// 提交复用 openapi 受理链;addr 空=不启用)。
// Day 62:注入 CMPP 系统默认配额(账号级 0 回退;连接数/单链速度强制)。
accSvc := access.New(db, openapiSvc, access.SystemLimits{
MaxConns: cfg.Server.CMPP.MaxConnsPerAccount,
SubmitRate: cfg.Server.CMPP.SubmitRatePerConn,
LongSmsWindow: cfg.Server.CMPP.LongSmsWindow, // Day 71:≤0 默认 72h
})
// Day 71:长短信挂起制——重启恢复+72h 到期扫描(不齐不发,LP 失败
// 终态+UNDELIV 回执经 Kafka cmpp-deliver 回环推下家在线连接)。
{
var lsPush report.PushSink
if p := a.Producer(); p != nil {
lsPush = &report.ProducerPushSink{P: p}
}
lsCtx, stopLS := context.WithCancel(context.Background())
accSvc.StartLongSmsMaintenance(lsCtx, lsPush, time.Minute)
a.OnShutdown(stopLS)
}
var cmppSrv *cmppproto.Server
if cfg.Server.CMPP.Addr != "" {
csrv := cmppproto.NewServer(cmppproto.ServerConfig{
Addr: cfg.Server.CMPP.Addr,
IdleTimeout: cfg.Server.CMPP.IdleTimeout,
}, accSvc)
cmppSrv = csrv
go func() {
if err := csrv.ListenAndServe(context.Background()); err != nil {
a.Lg().Error("cmpp_server_failed", zap.Error(err))
}
}()
a.OnShutdown(csrv.Close)
a.Lg().Info("cmpp_access_server_ready", zap.String("addr", cfg.Server.CMPP.Addr))
}
// Day 61(P0.5):cmpp-deliver 消费桥——report 终态事件(consumer 进程投递)
// →本进程 CMPP 会话注册表 PushDeliver。独立消费组;producer 缺省时跳过。
if cfg.Server.CMPP.Addr != "" {
delTopic := cfg.Kafka.Topics[queue.KeyDeliver]
if delTopic == "" {
delTopic = queue.TopicDeliver
}
pusher := access.NewDeliverPusher(db, cmppSrv)
dcg, derr := queue.NewConsumerGroup(queue.ConsumerGroupConfig{
Consumer: queue.ConsumerConfig{
Brokers: cfg.Kafka.Brokers,
GroupID: "gateway-cmpp-deliver",
Topics: []string{delTopic},
Logger: a.Lg(),
Oldest: false, // 只推在线会话;历史事件无会话可推,latest 起点即可
Handler: func(ctx context.Context, msg *sarama.ConsumerMessage) error {
return pusher.HandlePayload(ctx, msg.Value)
},
},
Producer: queue.ProducerConfig{Brokers: cfg.Kafka.Brokers, Logger: a.Lg()},
})
if derr != nil {
a.Lg().Error("cmpp_deliver_consumer_init_failed", zap.Error(derr))
} else {
go func() {
if err := dcg.Run(context.Background()); err != nil {
a.Lg().Error("cmpp_deliver_consumer_exit", zap.Error(err))
}
}()
a.OnShutdown(func() { _ = dcg.Close() })
a.Lg().Info("cmpp_deliver_consumer_ready",
zap.String("topic", delTopic), zap.String("group", "gateway-cmpp-deliver"))
}
}
if cfg.Server.SMPP.Addr != "" {
ssrv := smppproto.NewServer(smppproto.ServerConfig{
Addr: cfg.Server.SMPP.Addr,
IdleTimeout: cfg.Server.SMPP.IdleTimeout,
}, accSvc)
go func() {
if err := ssrv.ListenAndServe(context.Background()); err != nil {
a.Lg().Error("smpp_server_failed", zap.Error(err))
}
}()
a.OnShutdown(ssrv.Close)
a.Lg().Info("smpp_access_server_ready", zap.String("addr", cfg.Server.SMPP.Addr))
}
// Day 43:待审任务 48h 超时扫描(置超时+幂等回退余额),随优雅停机拆除。
scannerCtx, stopScanner := context.WithCancel(context.Background())
go audit.NewTimeoutScanner(db).Run(scannerCtx)
a.OnShutdown(stopScanner)
a.Lg().Info("audit_timeout_scanner_started")
// Day 27:余额预警定时扫描(每分钟;启动即扫一次),随优雅停机退出
sched := &cronx.Scheduler{}
_ = sched.Add(cronx.Job{
Name: "balance_warning", Interval: time.Minute, Immediate: true,
Run: func(ctx context.Context) error {
_, err := warnSvc.ScanOnce(ctx)
return err
},
OnError: func(name string, err error) {
a.Lg().Warn("cron_job_failed", zap.String("job", name), zap.Error(err))
},
})
// Day 40(A-3.12):通道告警扫描——链路全断/失败率超阈值,30s 周期
// (断连事件另有 onDrop 即时评估路径,冷却 CooldownMin 去重兜底)。
_ = sched.Add(cronx.Job{
Name: "channel_alert", Interval: 30 * time.Second, Immediate: true,
Run: func(ctx context.Context) error {
_, err := chSvc.AlertService().ScanOnce(ctx)
return err
},
OnError: func(name string, err error) {
a.Lg().Warn("cron_job_failed", zap.String("job", name), zap.Error(err))
},
})
sched.Start()
a.OnShutdown(sched.Stop)
a.Lg().Info("balance_warning_scheduler_started", zap.String("interval", "1m"))
a.Lg().Info("channel_alert_scheduler_started", zap.String("interval", "30s"))
},
})
}