## 高优先级修复 - stats_service_impl: 使用 strings.SplitN 替代错误的索引分割 - provider_handler: 使用 errors.Is(err, gorm.ErrDuplicatedKey) 替代字符串匹配 - client: 重写 isNetworkError 使用 errors.As/Is 类型安全判断 - proxy_handler: 使用 encoding/json 标准库解析 JSON(extractModelName、isStreamRequest) ## 中优先级修复 - stats_handler: 添加 parseDateParam 辅助函数消除重复日期解析 - pkg/errors: 新增 ErrRequestCreate/Send/ResponseRead 错误类型和 WithCause 方法 - client: 使用结构化错误替代 fmt.Errorf - ConversionEngine: logger 依赖注入,替换所有 zap.L() 调用 ## 低优先级修复 - encoder: 删除 joinStrings,使用 strings.Join - adapter: 删除 modelInfoRegex 正则,使用 isModelInfoPath 字符串函数 ## 文档更新 - README.md: 添加公共库使用指南和编码规范章节 - specs: 同步 delta specs 到 main specs(error-handling、structured-logging、request-validation) ## 归档 - openspec/changes/archive/2026-04-20-refactor-backend-code-quality/
245 lines
6.5 KiB
Go
245 lines
6.5 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"log"
|
|
"net/http"
|
|
"os"
|
|
"os/signal"
|
|
"path/filepath"
|
|
"runtime"
|
|
"syscall"
|
|
"time"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
"github.com/pressly/goose/v3"
|
|
"go.uber.org/zap"
|
|
"gorm.io/driver/sqlite"
|
|
"gorm.io/gorm"
|
|
"gorm.io/gorm/logger"
|
|
|
|
"nex/backend/internal/config"
|
|
"nex/backend/internal/conversion"
|
|
"nex/backend/internal/conversion/anthropic"
|
|
"nex/backend/internal/conversion/openai"
|
|
"nex/backend/internal/handler"
|
|
"nex/backend/internal/handler/middleware"
|
|
"nex/backend/internal/provider"
|
|
"nex/backend/internal/repository"
|
|
"nex/backend/internal/service"
|
|
pkgLogger "nex/backend/pkg/logger"
|
|
)
|
|
|
|
func main() {
|
|
// 1. 加载配置
|
|
cfg, err := config.LoadConfig()
|
|
if err != nil {
|
|
log.Fatalf("加载配置失败: %v", err)
|
|
}
|
|
if err := cfg.Validate(); err != nil {
|
|
log.Fatalf("配置验证失败: %v", err)
|
|
}
|
|
|
|
// 2. 初始化日志
|
|
zapLogger, err := pkgLogger.New(pkgLogger.Config{
|
|
Level: cfg.Log.Level,
|
|
Path: cfg.Log.Path,
|
|
MaxSize: cfg.Log.MaxSize,
|
|
MaxBackups: cfg.Log.MaxBackups,
|
|
MaxAge: cfg.Log.MaxAge,
|
|
Compress: cfg.Log.Compress,
|
|
})
|
|
if err != nil {
|
|
log.Fatalf("初始化日志失败: %v", err)
|
|
}
|
|
defer zapLogger.Sync()
|
|
|
|
// 3. 初始化数据库
|
|
db, err := initDatabase(cfg)
|
|
if err != nil {
|
|
zapLogger.Fatal("初始化数据库失败", zap.String("error", err.Error()))
|
|
}
|
|
defer closeDB(db)
|
|
|
|
// 4. 初始化 repository 层
|
|
providerRepo := repository.NewProviderRepository(db)
|
|
modelRepo := repository.NewModelRepository(db)
|
|
statsRepo := repository.NewStatsRepository(db)
|
|
|
|
// 5. 初始化 service 层
|
|
providerService := service.NewProviderService(providerRepo)
|
|
modelService := service.NewModelService(modelRepo, providerRepo)
|
|
routingService := service.NewRoutingService(modelRepo, providerRepo)
|
|
statsService := service.NewStatsService(statsRepo)
|
|
|
|
// 6. 创建 ConversionEngine
|
|
registry := conversion.NewMemoryRegistry()
|
|
if err := registry.Register(openai.NewAdapter()); err != nil {
|
|
zapLogger.Fatal("注册 OpenAI 适配器失败", zap.String("error", err.Error()))
|
|
}
|
|
if err := registry.Register(anthropic.NewAdapter()); err != nil {
|
|
zapLogger.Fatal("注册 Anthropic 适配器失败", zap.String("error", err.Error()))
|
|
}
|
|
engine := conversion.NewConversionEngine(registry, zapLogger)
|
|
|
|
// 7. 初始化 provider client
|
|
providerClient := provider.NewClient()
|
|
|
|
// 8. 初始化 handler 层
|
|
proxyHandler := handler.NewProxyHandler(engine, providerClient, routingService, providerService, statsService)
|
|
providerHandler := handler.NewProviderHandler(providerService)
|
|
modelHandler := handler.NewModelHandler(modelService)
|
|
statsHandler := handler.NewStatsHandler(statsService)
|
|
|
|
// 9. 创建 Gin 引擎
|
|
gin.SetMode(gin.ReleaseMode)
|
|
r := gin.New()
|
|
|
|
r.Use(middleware.RequestID())
|
|
r.Use(middleware.Recovery(zapLogger))
|
|
r.Use(middleware.Logging(zapLogger))
|
|
r.Use(middleware.CORS())
|
|
|
|
setupRoutes(r, proxyHandler, providerHandler, modelHandler, statsHandler)
|
|
|
|
// 10. 启动服务器
|
|
srv := &http.Server{
|
|
Addr: formatAddr(cfg.Server.Port),
|
|
Handler: r,
|
|
ReadTimeout: cfg.Server.ReadTimeout,
|
|
WriteTimeout: cfg.Server.WriteTimeout,
|
|
}
|
|
|
|
go func() {
|
|
zapLogger.Info("AI Gateway 启动", zap.String("addr", srv.Addr))
|
|
if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
|
|
zapLogger.Fatal("服务器启动失败", zap.String("error", err.Error()))
|
|
}
|
|
}()
|
|
|
|
quit := make(chan os.Signal, 1)
|
|
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
|
|
<-quit
|
|
|
|
zapLogger.Info("正在关闭服务器...")
|
|
|
|
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
|
|
defer cancel()
|
|
|
|
if err := srv.Shutdown(ctx); err != nil {
|
|
zapLogger.Fatal("服务器强制关闭", zap.String("error", err.Error()))
|
|
}
|
|
|
|
zapLogger.Info("服务器已关闭")
|
|
}
|
|
|
|
func initDatabase(cfg *config.Config) (*gorm.DB, error) {
|
|
db, err := gorm.Open(sqlite.Open(cfg.Database.Path), &gorm.Config{
|
|
Logger: logger.Default.LogMode(logger.Info),
|
|
})
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
if err := db.Exec("PRAGMA journal_mode=WAL").Error; err != nil {
|
|
log.Printf("警告: 启用 WAL 模式失败: %v", err)
|
|
}
|
|
|
|
if err := runMigrations(db); err != nil {
|
|
return nil, fmt.Errorf("数据库迁移失败: %w", err)
|
|
}
|
|
|
|
sqlDB, err := db.DB()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
sqlDB.SetMaxIdleConns(cfg.Database.MaxIdleConns)
|
|
sqlDB.SetMaxOpenConns(cfg.Database.MaxOpenConns)
|
|
sqlDB.SetConnMaxLifetime(cfg.Database.ConnMaxLifetime)
|
|
|
|
log.Printf("数据库连接池配置: MaxIdle=%d, MaxOpen=%d, MaxLifetime=%v",
|
|
cfg.Database.MaxIdleConns, cfg.Database.MaxOpenConns, cfg.Database.ConnMaxLifetime)
|
|
|
|
return db, nil
|
|
}
|
|
|
|
func runMigrations(db *gorm.DB) error {
|
|
sqlDB, err := db.DB()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
migrationsDir := getMigrationsDir()
|
|
if _, err := os.Stat(migrationsDir); os.IsNotExist(err) {
|
|
return fmt.Errorf("迁移目录不存在: %s", migrationsDir)
|
|
}
|
|
|
|
goose.SetDialect("sqlite3")
|
|
if err := goose.Up(sqlDB, migrationsDir); err != nil {
|
|
return err
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func getMigrationsDir() string {
|
|
_, filename, _, ok := runtime.Caller(0)
|
|
if ok {
|
|
dir := filepath.Join(filepath.Dir(filename), "..", "..", "migrations")
|
|
if abs, err := filepath.Abs(dir); err == nil {
|
|
return abs
|
|
}
|
|
}
|
|
return "./migrations"
|
|
}
|
|
|
|
func closeDB(db *gorm.DB) {
|
|
sqlDB, err := db.DB()
|
|
if err != nil {
|
|
return
|
|
}
|
|
sqlDB.Close()
|
|
}
|
|
|
|
func formatAddr(port int) string {
|
|
return fmt.Sprintf(":%d", port)
|
|
}
|
|
|
|
func setupRoutes(r *gin.Engine, proxyHandler *handler.ProxyHandler, providerHandler *handler.ProviderHandler, modelHandler *handler.ModelHandler, statsHandler *handler.StatsHandler) {
|
|
// 统一代理入口: /{protocol}/v1/{path}
|
|
r.Any("/:protocol/v1/*path", proxyHandler.HandleProxy)
|
|
|
|
// 供应商管理 API
|
|
providers := r.Group("/api/providers")
|
|
{
|
|
providers.GET("", providerHandler.ListProviders)
|
|
providers.POST("", providerHandler.CreateProvider)
|
|
providers.GET("/:id", providerHandler.GetProvider)
|
|
providers.PUT("/:id", providerHandler.UpdateProvider)
|
|
providers.DELETE("/:id", providerHandler.DeleteProvider)
|
|
}
|
|
|
|
// 模型管理 API
|
|
models := r.Group("/api/models")
|
|
{
|
|
models.GET("", modelHandler.ListModels)
|
|
models.POST("", modelHandler.CreateModel)
|
|
models.GET("/:id", modelHandler.GetModel)
|
|
models.PUT("/:id", modelHandler.UpdateModel)
|
|
models.DELETE("/:id", modelHandler.DeleteModel)
|
|
}
|
|
|
|
// 统计查询 API
|
|
stats := r.Group("/api/stats")
|
|
{
|
|
stats.GET("", statsHandler.GetStats)
|
|
stats.GET("/aggregate", statsHandler.AggregateStats)
|
|
}
|
|
|
|
// 健康检查
|
|
r.GET("/health", func(c *gin.Context) {
|
|
c.JSON(200, gin.H{"status": "ok"})
|
|
})
|
|
}
|