后端与全仓代码质量清理（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%)

pkg/geoip/country_centroid.go

@@ -1,3 +1,6 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
 package geoip
 
 import "strings"
@@ -194,7 +197,7 @@ func CountryCentroidByName(name string) (lat float64, lon float64, ok bool) {
 		return v.lat, v.lon, true
 	}
 	// Try comma-separated parts (city / region / country / ISO).
-	for _, part := range strings.Split(name, ",") {
+	for part := range strings.SplitSeq(name, ",") {
 		part = strings.TrimSpace(part)
 		if part == "" {
 			continue

pkg/geoip/country_centroid_test.go

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

pkg/geoip/emptyProvider.go

@@ -1,7 +1,10 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
 package geoip
 
 import (
-	"fmt"
+	"errors"
 	"net"
 )
 
@@ -20,12 +23,12 @@ func (e *EmptyProvider) Initialize() error {
 
 // GetGeoInfo reports that no GeoIP provider has been configured.
 func (e *EmptyProvider) GetGeoInfo(_ net.IP) (*GeoInfo, error) {
-	return nil, fmt.Errorf("you are using an empty GeoIP provider, please set a valid provider")
+	return nil, errors.New("you are using an empty GeoIP provider, please set a valid provider")
 }
 
 // UpdateDatabase reports that no GeoIP provider has been configured.
 func (e *EmptyProvider) UpdateDatabase() error {
-	return fmt.Errorf("you are using an empty GeoIP provider, please set a valid provider")
+	return errors.New("you are using an empty GeoIP provider, please set a valid provider")
 }
 
 // Close releases resources held by the empty provider.

pkg/geoip/geoip.go

@@ -1,7 +1,11 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
 // Package geoip resolves geographic information for IP addresses.
 package geoip
 
 import (
+	"errors"
 	"fmt"
 	"log/slog"
 	"net"
@@ -138,7 +142,7 @@ func InitGeoIP(provider string) {
 // GetGeoInfo looks up geographic information for ip using the active provider.
 func GetGeoInfo(ip net.IP) (*GeoInfo, error) {
 	if ip == nil {
-		return nil, fmt.Errorf("IP address cannot be nil")
+		return nil, errors.New("IP address cannot be nil")
 	}
 	provider := getProvider()
 	cacheKey := provider.Name() + ":" + ip.String()
@@ -157,7 +161,7 @@ func GetGeoInfo(ip net.IP) (*GeoInfo, error) {
 // LookupGeoInfoWithProvider looks up geographic information using a temporary provider.
 func LookupGeoInfoWithProvider(providerName string, ip net.IP) (*GeoInfo, error) {
 	if ip == nil {
-		return nil, fmt.Errorf("IP address cannot be nil")
+		return nil, errors.New("IP address cannot be nil")
 	}
 
 	provider, err := providerFactory(normalizeProvider(providerName))

pkg/geoip/geoip_test.go

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

pkg/geoip/geojs.go

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

pkg/geoip/ipapi.go

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

pkg/geoip/ipinfo.go

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

pkg/geoip/iputil/iputil.go

@@ -1,3 +1,6 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
 // Package iputil provides helpers for parsing, normalizing, and scoring IP addresses.
 package iputil
 

pkg/geoip/iputil/iputil_test.go

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

pkg/geoip/mmdb.go

@@ -1,7 +1,11 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
 package geoip
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"io"
 	"net"
@@ -96,10 +100,10 @@ func (s *MaxMindGeoIPService) GetGeoInfo(ip net.IP) (*GeoInfo, error) {
 	defer s.mu.RUnlock()
 
 	if s.maxMindDBReader == nil {
-		return nil, fmt.Errorf("MaxMind database is not initialized or failed to open")
+		return nil, errors.New("MaxMind database is not initialized or failed to open")
 	}
 	if ip == nil {
-		return nil, fmt.Errorf("IP address cannot be nil")
+		return nil, errors.New("IP address cannot be nil")
 	}
 
 	var record Record

pkg/geoip/outboundip.go

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

pkg/geoip/outboundip_test.go

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