本文讲解如何将扁平化的 sql 预约表（含 year/month/day/hour 字段）按年-月-日-小时层级，精准映射为 go 中的嵌套结构（year → []month → []day → map[int]bool），并提供可运行的查询逻辑、结构设计优化与内存安全实践。
本文讲解如何将扁平化的 sql 预约表（含 year/month/day/hour 字段）按年-月-日-小时层级，精准映射为 go 中的嵌套结构（year → []month → []day → map[int]bool），并提供可运行的查询逻辑、结构设计优化与内存安全实践。
在构建教学预约类日历系统时，直接将关系型数据库中按行存储的 appointments 表映射为内存中的树状结构（如 year → month → day → hour availability）是常见但易出错的需求。原始结构体命名（如 year、month）违反 Go 命名规范（首字母应大写），且缺乏字段导出与初始化保障；更重要的是，SQL 查询结果是扁平的多行记录，而目标结构是深度嵌套的稀疏树——需手动聚合，而非 ORM 自动填充。
✅ 推荐结构定义（符合 Go 规范 + 安全初始化）
type Year struct {
Year int `json:"year"`
Months []Month `json:"months"`
}
type Month struct {
Month int `json:"month"`
Days []Day `json:"days"`
}
type Day struct {
Day int `json:"day"`
Hours map[int]bool `json:"hours"` // key: hour (e.g., 10, 14), value: booked? true/false
}
// NewDay 初始化 Day，避免 nil map 导致 panic
func NewDay(day int) Day {
return Day{
Day: day,
Hours: make(map[int]bool),
}
}
✅ 映射逻辑：从 SQL 结果构建嵌套结构
假设你已通过 database/sql 执行如下查询（注意：ORDER BY year, month, day, hour 比 day, month, year 更利于顺序聚合）：
SELECT year, month, day, hour, booked FROM appointments WHERE teacher = ? ORDER BY year, month, day, hour;
Go 端聚合代码示例（无第三方库，纯标准库）：
func BuildCalendar(rows *sql.Rows) ([]Year, error) {
var years []Year
var currentYear *Year
var currentMonth *Month
var currentDay *Day
for rows.Next() {
var y, m, d, h int
var booked bool
if err := rows.Scan(&y, &m, &d, &h, &booked); err != nil {
return nil, err
}
// Step 1: Ensure Year exists
if currentYear == nil || currentYear.Year != y {
currentYear = &Year{Year: y}
years = append(years, *currentYear)
}
// Step 2: Ensure Month exists in currentYear
monthFound := false
for i := range currentYear.Months {
if currentYear.Months[i].Month == m {
currentMonth = ¤tYear.Months[i]
monthFound = true
break
}
}
if !monthFound {
currentMonth = &Month{Month: m}
currentYear.Months = append(currentYear.Months, *currentMonth)
}
// Step 3: Ensure Day exists in currentMonth
dayFound := false
for i := range currentMonth.Days {
if currentMonth.Days[i].Day == d {
currentDay = ¤tMonth.Days[i]
dayFound = true
break
}
}
if !dayFound {
currentDay = &NewDay(d)
currentMonth.Days = append(currentMonth.Days, *currentDay)
}
// Step 4: Set hour availability
currentDay.Hours[h] = booked
}
return years, rows.Err()
}
⚠️ 关键注意事项
-
不要依赖
ORDER BY day, month, year：该顺序会导致跨年/跨月时结构重建混乱；必须按year, month, day, hour升序，保证数据流天然符合嵌套层级。 -
避免 nil map panic：
Day.Hours必须用make(map[int]bool)初始化（见NewDay），否则currentDay.Hours[h] = booked会 panic。 -
内存效率考量：若仅加载“未来 3 个月”，应在 SQL 中加
WHERE year >= ? AND (year > ? OR month >= ?)范围过滤，而非在 Go 中裁剪；数据库过滤永远优于内存过滤。 -
扩展性建议：实际项目中，可引入
map[[3]int]*Day（key:[year,month,day]）做二级索引，支持 O(1) 随机访问某天；或改用map[int]map[int]map[int]map[int]bool（年→月→日→小时）提升写入性能（牺牲部分可读性）。
✅ 总结
将扁平 SQL 日历表映射为 Go 嵌套结构，核心在于按有序结果流式聚合 + 显式初始化 + 层级守卫。无需复杂中间表或时间维度预生成（如 SQL Server 的 date/time interval 表），尤其在 MySQL 环境下，应用层聚合更灵活可控。最终结构清晰、可 JSON 序列化、易于前端渲染，且完全规避了 ORM 对深度嵌套的映射盲区。
