Files
xlgo-core/utils/validator.go
T
杭州明婳科技 6595e94677 fix: 多模型评审终审收口 — P0安全 + 主线A并发治理 + 文档对齐
经 deepseek/GLM/Claude 三轮对抗性评审 + 交叉核验 + 终审(见
last_report.md、cross_review_assessment.md),逐条回读源码核实并修复。
go build / vet / test -race ./... 全绿。

安全(P0):
- JWT alg confusion:WithValidMethods 固定 HMAC + keyfunc 方法断言
- JWT 空密钥 / 不支持算法 fail-closed(ErrEmptySecret / ErrUnsupportedAlgorithm)
- 上传大小实测封顶(enforceUploadSize),不信任客户端 file.Size
- HTTP headers/cookies map 竞态(写锁+快照)+ SSRF 防护(opt-in dialer.Control)

并发/资源(主线A 闭合):
- 包级可变全局一律 atomic.Pointer:DefaultRedis / DefaultStorage /
  DefaultManager / Validator / DefaultCache 等,消除裸指针数据竞争
- trace.Close 去 sync.Once(防 exporter 泄漏);app OnReady 失败走 Shutdown
- ws.Hub.Stop stopOnce 防 double-close;cron 接入 App 生命周期(WithCron)
- ratelimit failClosed atomic.Bool;Recover Written() 守卫
- cron checkAndRun 锁内收集锁外 spawn(wg.Add 在锁内防 Stop 竞态)

终审剩余项收口(H-A~M-H + L 系列):
- 副本连接池 MaxOpenConns/2 截断修复(replicaMaxOpenConns)
- JWT 黑名单 1s 超时 + 显式错误;ratelimit GetRedis 取一次复用
- GetPage 深分页上限;HashFile 流式;ReadFile 去 TOCTOU
- config Clone() 深拷贝;cache 锁操作返 ErrRedisNotReady
- compress 解压残留清理;正则预编译;EqualsIgnoreCase→EqualFold
- 删 redisLimiters 死代码;CLI 输入校验 + 回滚

文档:
- README/GUIDE/CHANGELOG 对齐当前 API(含破坏性变更迁移说明)
- docs/README 索引修正;config 注释修正(RS256 已不支持)

破坏性变更详见 CHANGELOG.md [Unreleased]。项目处于研发初期、无下游用户。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-03 23:16:03 +08:00

121 lines
2.6 KiB
Go

package utils
import (
"regexp"
)
// L-B 修复:正则预编译到包级变量,避免 IsPhone/IsEmail/IsIPv4/IsIDCard 每次调用
// regexp.MatchString 重编译(高 QPS 下浪费 CPU)。零行为变化。
var (
phoneRE = regexp.MustCompile(`^1[3-9]\d{9}$`)
emailRE = regexp.MustCompile(`^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$`)
ipv4RE = regexp.MustCompile(`^(\d{1,3}\.){3}\d{1,3}$`)
idCardRE = regexp.MustCompile(`^\d{6}(19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$`)
)
// IsPhone 检查是否为有效的中国大陆手机号
// 注意: 正则基于当前号段,新号段开放时需更新
func IsPhone(phone string) bool {
return phoneRE.MatchString(phone)
}
// IsEmail 检查是否为有效的邮箱地址
func IsEmail(email string) bool {
return emailRE.MatchString(email)
}
// IsIPv4 检查是否为有效的 IPv4 地址
func IsIPv4(ip string) bool {
if !ipv4RE.MatchString(ip) {
return false
}
// 验证每个段在 0-255 范围内
parts := splitByDot(ip)
for _, part := range parts {
n := ToInt(part)
if n < 0 || n > 255 {
return false
}
}
return true
}
// IsIDCard 检查是否为有效的中国身份证号(18位)
// 注意: 仅校验格式,不校验校验位
func IsIDCard(id string) bool {
return idCardRE.MatchString(id)
}
// IsChinese 检查字符串是否全部为中文字符
func IsChinese(s string) bool {
for _, r := range s {
if r < 0x4E00 || r > 0x9FFF {
return false
}
}
return len(s) > 0
}
// HasChinese 检查字符串是否包含中文字符
func HasChinese(s string) bool {
for _, r := range s {
if r >= 0x4E00 && r <= 0x9FFF {
return true
}
}
return false
}
// IsNumeric 检查字符串是否全部为数字
func IsNumeric(s string) bool {
if len(s) == 0 {
return false
}
for _, r := range s {
if r < '0' || r > '9' {
return false
}
}
return true
}
// IsAlpha 检查字符串是否全部为字母
func IsAlpha(s string) bool {
if len(s) == 0 {
return false
}
for _, r := range s {
if (r < 'a' || r > 'z') && (r < 'A' || r > 'Z') {
return false
}
}
return true
}
// IsAlphanumeric 检查字符串是否全部为字母或数字
func IsAlphanumeric(s string) bool {
if len(s) == 0 {
return false
}
for _, r := range s {
if (r < 'a' || r > 'z') && (r < 'A' || r > 'Z') && (r < '0' || r > '9') {
return false
}
}
return true
}
// 内部函数
func splitByDot(s string) []string {
var result []string
start := 0
for i := 0; i < len(s); i++ {
if s[i] == '.' {
result = append(result, s[start:i])
start = i + 1
}
}
result = append(result, s[start:])
return result
}