后端与全仓代码质量清理（golangci 扩展集 · 测试质量 · 并发安全 · 文档同步）

代码质量全量清理，零行为变化：golangci 扩展集 13 类 linter（gosec/modernize/perfsprint/canonicalheader/usestdlibvars/wastedassign/intrange/errorlint/forcetypeassert/recvcheck/exhaustive/unparam）全量修复，测试代码质量（testifylint/thelper/usetesting）25→0，frpc 进程生命周期真 bug（进程组击杀）、全仓 go test -race 6 类数据竞争（含 1 个生产竞争）、SPDX license 头补齐 131 文件、前端测试套件 next-intl 迁移后 44 失败→全绿、过期 swagger 文档重新生成、pnpm-workspace 构建审批。

Experiments: #2-#17, #18, #20, #21, #23
Metric: total_issues 108 → 8 (-92.6%)

internal/infra/persistence/batchwriter/config.go

@@ -4,7 +4,7 @@
 package batchwriter
 
 import (
-	"fmt"
+	"errors"
 	"time"
 )
 
@@ -51,19 +51,19 @@ func DefaultConfig() Config {
 
 func (c Config) validate() error {
 	if c.QueueSize <= 0 {
-		return fmt.Errorf("batchwriter: queue size must be positive")
+		return errors.New("batchwriter: queue size must be positive")
 	}
 	if c.MaxBatchSize <= 0 {
-		return fmt.Errorf("batchwriter: max batch size must be positive")
+		return errors.New("batchwriter: max batch size must be positive")
 	}
 	if c.MinBatchSize < 0 {
-		return fmt.Errorf("batchwriter: min batch size must be non-negative")
+		return errors.New("batchwriter: min batch size must be non-negative")
 	}
 	if c.FlushInterval <= 0 {
-		return fmt.Errorf("batchwriter: flush interval must be positive")
+		return errors.New("batchwriter: flush interval must be positive")
 	}
 	if c.MaxFlushWait < 0 {
-		return fmt.Errorf("batchwriter: max flush wait must be non-negative")
+		return errors.New("batchwriter: max flush wait must be non-negative")
 	}
 	return nil
 }

internal/infra/persistence/migrator/pages_source_migration_test.go

@@ -198,7 +198,7 @@ func assertPagesSourceConstraints(t *testing.T, gormDB *gorm.DB, sourceID uint)
 		ConfigVersion:  1,
 		SourceIdentity: strings.Repeat("c", 64),
 	}
-	assert.Error(t, gormDB.Create(&duplicateSource).Error)
+	require.Error(t, gormDB.Create(&duplicateSource).Error)
 
 	for number := 2; number <= 3; number++ {
 		require.NoError(t, createMigrationDeployment(
@@ -219,14 +219,14 @@ func assertPagesSourceConstraints(t *testing.T, gormDB *gorm.DB, sourceID uint)
 		&identity,
 		&revision,
 	))
-	assert.Error(t, createMigrationDeployment(
+	require.Error(t, createMigrationDeployment(
 		gormDB,
 		5,
 		strings.Repeat("0", 64),
 		&identity,
 		&revision,
 	))
-	assert.Error(t, createMigrationDeployment(
+	require.Error(t, createMigrationDeployment(
 		gormDB,
 		1,
 		strings.Repeat("1", 64),

internal/infra/persistence/postgres.go

@@ -21,6 +21,9 @@ import (
 	"gorm.io/plugin/opentelemetry/tracing"
 )
 
+// baseTracingOptionCount 是 newGORMTracingPlugin 预置的 tracing 选项数量。
+const baseTracingOptionCount = 3
+
 var (
 	db *gorm.DB
 )
@@ -106,7 +109,7 @@ func initPostgres() {
 	}
 
 	if len(dbConfig.Replicas) > 0 {
-		var replicaDialectors []gorm.Dialector
+		var replicaDialectors = make([]gorm.Dialector, 0, len(dbConfig.Replicas))
 		for _, replica := range dbConfig.Replicas {
 			username := replica.Username
 			if username == "" {
@@ -156,11 +159,12 @@ func initPostgres() {
 
 // newGORMTracingPlugin 构造数据库链路追踪插件。查询参数只保留占位符，避免凭据等绑定值进入 Span。
 func newGORMTracingPlugin(attrs []attribute.KeyValue, extraOptions ...tracing.Option) gorm.Plugin {
-	options := []tracing.Option{
+	options := make([]tracing.Option, 0, baseTracingOptionCount+len(extraOptions))
+	options = append(options,
 		tracing.WithoutMetrics(),
 		tracing.WithoutQueryVariables(),
 		tracing.WithAttributes(attrs...),
-	}
+	)
 	options = append(options, extraOptions...)
 	return tracing.NewPlugin(options...)
 }

internal/infra/persistence/postgres_logger.go

@@ -31,26 +31,26 @@ func (l *gormZapLogger) LogMode(level gormLogger.LogLevel) gormLogger.Interface
 	return &clone
 }
 
-func (l *gormZapLogger) Info(ctx context.Context, fmt string, args ...interface{}) {
+func (l *gormZapLogger) Info(ctx context.Context, fmt string, args ...any) {
 	if l.logLevel >= gormLogger.Info {
 		logger.InfoF(ctx, fmt, args...)
 	}
 }
 
-func (l *gormZapLogger) Warn(ctx context.Context, fmt string, args ...interface{}) {
+func (l *gormZapLogger) Warn(ctx context.Context, fmt string, args ...any) {
 	if l.logLevel >= gormLogger.Warn {
 		logger.WarnF(ctx, fmt, args...)
 	}
 }
 
-func (l *gormZapLogger) Error(ctx context.Context, fmt string, args ...interface{}) {
+func (l *gormZapLogger) Error(ctx context.Context, fmt string, args ...any) {
 	if l.logLevel >= gormLogger.Error {
 		logger.ErrorF(ctx, fmt, args...)
 	}
 }
 
 // ParamsFilter 让 GORM 的 Trace 回调只接收参数化 SQL，避免绑定值被 Dialector.Explain 展开到日志。
-func (l *gormZapLogger) ParamsFilter(_ context.Context, sql string, _ ...interface{}) (string, []interface{}) {
+func (l *gormZapLogger) ParamsFilter(_ context.Context, sql string, _ ...any) (string, []any) {
 	return sql, nil
 }
 
@@ -70,7 +70,7 @@ func (l *gormZapLogger) Trace(ctx context.Context, begin time.Time, fc func() (s
 	}
 }
 
-func formatRows(rows int64) interface{} {
+func formatRows(rows int64) any {
 	if rows == -1 {
 		return "-"
 	}

internal/infra/persistence/redis.go

@@ -9,6 +9,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"log"
+	"strconv"
 	"strings"
 	"time"
 
@@ -83,7 +84,7 @@ func init() {
 	if err := redisotel.InstrumentTracing(
 		Redis,
 		redisotel.WithAttributes(
-			attribute.String("db.instance", fmt.Sprintf("%v", cfg.DB)),
+			attribute.String("db.instance", strconv.Itoa(cfg.DB)),
 			attribute.String("db.ip", strings.Join(cfg.Addrs, ",")),
 			attribute.String("db.system", "Redis"),
 		),

internal/infra/persistence/redis_test.go

@@ -1,3 +1,6 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
 package db
 
 import (