老实说，

TCP 长连接服务：登录注册认证程序实战教程

连接准入认证是服务安全的第一道防线。

需要实现一套「先认证、后业务」的流程：客户端 TCP 连接建立后不直接开放业务能力。必须完成注册 / 登录并通过校验，才能进入正常的协议交互流程。

整体流程与主要设计原则

主要流程

连接接入：客户端TCP建联成功 → 服务端不标记在线，仅返回认证提示
至于认证阶段，客户端发送注册/登录命令 → 服务端校验合法性 → 完成数据库操作
从业务阶段来看，认证通过 → 标记使用者在线、设置认证状态 → 进入正常协议/命令处理流程

主要设计原则

1. 状态隔离用认证标记严格区分「未认证连接」和「已认证连接」。未认证连接仅能处理注册 / 登录命令
2. 安全优先密码全程不落地明文，用 bcrypt 单向哈希存储与校验
3. 职责分层连接处理、认证逻辑、数据库操作严格分层，避免代码耦合
4. 边界校验全流程做输入合法性、重复登录、资源初始化检查，避免异常与安全漏洞

主要数据结构设计

内存使用者连接结构

用于管理单条 TCP 连接的生命周期与状态，主要是认证状态标记这是分阶段处理的主要依据。

type User struct {
Conn net.Conn // 底层TCP连接
Name string // 使用者名
Aunticated bool // 是否通过认证
mu sync.RWMutex// 读写锁，保护状态并发修改}
// 标记使用者在线
func Online {
u.mu.Lock
defer u.mu.Unlock
// 逻辑：加入全局在线使用者列表}
// 标记使用者离线
func Offline {
u.mu.Lock
defer u.mu.Unlock
// 逻辑：从全局在线使用者列表移除}
}

• 说到主要语法说明。Aunticated 布尔值是整个流程的开关，未认证时所有业务命令都会被拦截
• 并发安全 : 使用者状态修改必须加锁,防止多 goroutine并发修改导致的状态异常

数据库持久化模型

用于存储使用者的主要数据,强调 密码哈希字段 ,决不存储明文密码。

// User 数据库使用者表模型
type User struct {
gorm.Model
Username string `gorm:"type:varchar;uniqueIndex，not null"` // 唯一索引 username PasswordHash string `gorm:"type:varchar;
not null"` // password hash IsOnline bool `gorm:"default:false"` // 在线状态 } }

字段设计说明 :

• uniqueIndex 给 username 加唯一索引。防止重复注册
• PasswordHash 字段长度预留位,支持 bcrypt 哈希结果的固定长度
• IsOnline 同步 username 的在线状态,便于 business 层查询。怎么说呢，

密码安全主要 : bcrypt单向加密

密码安全是 auntication system 的 core。我们使用领域标准 bcrypt algorithm实现 password 的单向哈希,无法从哈希结果反推明文 password,彻底避免明文 password 泄露风险。

bcrypt仅需两个 core API。就可以完成 password 加密与校验,无需复杂配置。

password hash生成

// 生成 password hash:明文 password→不可逆 hash字符串
// 参数1:明文 password 的 byte数组
// 参数2:hash成本
hashBytes,err := bcrypt.GenerateFromPassword,bcrypt.DefaultCost)
passwordHash := string // store to db of final result.

password hash比对

// 比对明文 password 和 database store 的 hash 值
// 参数1:db 中 store 的 passwrd hash
// 参数2:user login input 的明文 passwrd
// return value:比对成功返回 nil。失败返回错误 err := bcrypt.CompareHashAndPassword,byte)

• core advantage :每次生成的哈希结果都不同,但可以正确比对同一 plain text passwrd,避免 rainbow table attack.

DAO Data Persistence Layer Design DAO layer封装所有 database operations实现 business logic and database operation decoupling同时统一做 db initialization check避免空指针 panic.

Create User