release: v1.0.3 bug fix release

v1.0.3 定位为 bug fix release,收口 v1.0.2 引入的破坏性清理并修复
4 个轻量 bug + 依赖复查 + 版本号治理 + 文档对齐。同时包含此前未提交
的 v1.0.2 全部工作。

v1.0.3 变更:

Fixed:
- generateJTI 忽略 rand.Read 错误(jwt)— 改为 (string, error) 并传播
- QueryBuilder.Page Count 受残留 Limit 截断(repository)— countDB 加 Limit(-1).Offset(-1)
- OSS/本地存储文件名冲突(storage)— 新增 uniqueFilename 加 8 字节随机后缀
- 数据库重试策略对不可恢复错误无效(database)— 新增 isTransientDBError

Dependencies:
- go mod tidy 补全 postgres 方言传递依赖;安全补丁升级
  x/crypto v0.49→v0.53、golang-jwt/jwt/v5 v5.2.1→v5.3.1、gorilla/websocket v1.5.1→v1.5.3

Removed:
- Breaking: 清理 v1.0.2 兼容别名(InitMySQL* / driverName)
- 死代码 database.DBResolver
- 代码中 292 行"评分/理由"自夸注释(#26,23 个文件)

Changed:
- Breaking: 错误码体系重构 CodeSuccess 1→0、CodeFail 0→1,删除 CodeInvalidParams,加编译期防撞码
- database/mysql.go → manager.go;Logger 拆分三独立 core 修复 Tee 重复写入
- 版本号常量化:app.go 新增 const Version 作为唯一来源,CLI/脚手架模板引用之,不再散落字面量

Security:
- CORS 中间件按 W3C 规范修复 Allow-Credentials / Vary: Origin / 非白名单不回显

Added:
- console 包显式 level 控制(SetLevel/WithLevel/LevelSilent,atomic.Int32 并发安全)
- 新增测试 jwt/repository/storage/database/router/middleware/app
- 文档:新增 CHANGELOG.md、Version_v1.0.2_report.md;更新 README/GUIDE 顶部更新日志
- 文档对齐:删除对不存在的 config.DefaultManager() getter 的描述(保持 API 与文档一致)

详见 CHANGELOG.md 与 README.md 更新日志。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
杭州明婳科技
2026-06-22 21:40:10 +08:00
parent 2cc8c70960
commit dcfd24b624
61 changed files with 5604 additions and 1299 deletions
-18
View File
@@ -5,8 +5,6 @@ import (
)
// IsPhone 检查是否为有效的中国大陆手机号
// 评分: ⭐⭐⭐⭐
// 理由: 常用验证,但正则需要随运营商号段更新
// 注意: 正则基于当前号段,新号段开放时需更新
func IsPhone(phone string) bool {
// 1开头,第二位为3-9,共11位
@@ -16,8 +14,6 @@ func IsPhone(phone string) bool {
}
// IsEmail 检查是否为有效的邮箱地址
// 评分: ⭐⭐⭐⭐
// 理由: 常用验证,简单正则覆盖大部分场景
func IsEmail(email string) bool {
// 简单邮箱验证:xxx@xxx.xxx
pattern := `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$`
@@ -26,8 +22,6 @@ func IsEmail(email string) bool {
}
// IsIPv4 检查是否为有效的 IPv4 地址
// 评分: ⭐⭐⭐⭐⭐
// 理由: 网络编程常用验证
func IsIPv4(ip string) bool {
pattern := `^(\d{1,3}\.){3}\d{1,3}$`
matched, _ := regexp.MatchString(pattern, ip)
@@ -46,8 +40,6 @@ func IsIPv4(ip string) bool {
}
// IsIDCard 检查是否为有效的中国身份证号(18位)
// 评分: ⭐⭐⭐
// 理由: 身份证验证需求常见,但校验位算法复杂,此为简化版
// 注意: 仅校验格式,不校验校验位
func IsIDCard(id string) bool {
// 18位身份证:6位地区码 + 8位生日 + 3位顺序码 + 1位校验码
@@ -57,8 +49,6 @@ func IsIDCard(id string) bool {
}
// IsChinese 检查字符串是否全部为中文字符
// 评分: ⭐⭐⭐⭐
// 理由: 中文内容校验常用
func IsChinese(s string) bool {
for _, r := range s {
if r < 0x4E00 || r > 0x9FFF {
@@ -69,8 +59,6 @@ func IsChinese(s string) bool {
}
// HasChinese 检查字符串是否包含中文字符
// 评分: ⭐⭐⭐⭐
// 理由: 混合内容检测
func HasChinese(s string) bool {
for _, r := range s {
if r >= 0x4E00 && r <= 0x9FFF {
@@ -81,8 +69,6 @@ func HasChinese(s string) bool {
}
// IsNumeric 检查字符串是否全部为数字
// 评分: ⭐⭐⭐⭐⭐
// 理由: 简单高效的数字检测
func IsNumeric(s string) bool {
if len(s) == 0 {
return false
@@ -96,8 +82,6 @@ func IsNumeric(s string) bool {
}
// IsAlpha 检查字符串是否全部为字母
// 评分: ⭐⭐⭐⭐
// 理由: 字母检测
func IsAlpha(s string) bool {
if len(s) == 0 {
return false
@@ -111,8 +95,6 @@ func IsAlpha(s string) bool {
}
// IsAlphanumeric 检查字符串是否全部为字母或数字
// 评分: ⭐⭐⭐⭐⭐
// 理由: 用户名、密码等常用验证
func IsAlphanumeric(s string) bool {
if len(s) == 0 {
return false