Go + Gin + SQLite 高校信息查询系统：从 Flask 迁移到 Go 的实战项目

标签: Go / Gin / SQLite / 高校查询 / 全栈项目 / 权限控制 / Session认证 / 开源
原文: 微信公众号「码农先森」https://mp.weixin.qq.com/s/2xH4zAo93OVrvEgoze25Eg
GitHub: https://github.com/Army-Mark/University-Information-Retrieval

项目简介

基于 Go 语言开发的高校信息查询系统，使用 Gin 框架 + SQLite 数据库，提供完整的学校信息管理、用户认证、权限控制、搜索功能和个性化设置。

项目背景

原项目用 Flask + SQLite 实现，Docker 部署后发现资源消耗较高，于是用 Go 重写。两个项目都是 AI 对话式开发的。

技术栈

主要功能

核心功能

• ✅ 学校信息管理：增删改查，包含地址、类别、性质、排名等详细字段
• ✅ 用户认证系统：基于 Session 的登录认证，密码强度验证
• ✅ 角色权限控制：管理员 (admin) + 普通用户 (user) 两种角色
• ✅ 智能搜索：按学校 ID 或名称搜索，分页 + 缓存优化
• ✅ 滚动数据展示：首页自动滚动展示学校信息
• ✅ Logo 上传管理：支持学校 Logo 上传和管理
• ✅ 操作日志记录：记录增删改操作，便于审计追踪
• ✅ 个性化设置：主题、语言、收藏学校等配置

项目结构

school-go/
├── cmd/server/main.go           # 应用入口
├── internal/
│   ├── api/
│   │   ├── handlers/            # HTTP 请求处理器
│   │   │   ├── university.go    # 学校相关
│   │   │   ├── user.go          # 用户相关
│   │   │   ├── settings.go      # 设置相关
│   │   │   └── operation_log_handler.go  # 操作日志
│   │   ├── middleware/auth.go   # 认证和角色验证中间件
│   │   └── routes.go            # 路由注册
│   ├── models/                  # 数据模型
│   ├── repository/              # 数据访问层
│   ├── service/                 # 业务逻辑层
│   ├── config/config.go         # 配置加载
│   └── pkg/errors/              # 自定义错误处理
├── static/                      # 静态资源（JS、Logo）
├── templates/                   # HTML 模板
├── scripts/                     # 工具脚本
└── go.mod / go.sum

数据库设计

用户表 (users)

学校表 (universities)

操作日志表 (operation_logs)

API 文档

公开接口（无需登录）

认证接口

需要登录的接口

权限矩阵

安全特性

输入验证

• XSS 防护：HTML 特殊字符转义
• SQL 注入防护：参数化查询
• 密码强度验证：至少 8 字符，必须含字母和数字

会话管理

• 安全 Cookie（HttpOnly、Secure）
• 会话有效期 24 小时
• 支持 Cookie 或请求头获取会话 ID

错误处理

• 统一错误处理中间件
• 自定义错误类型：BadRequest / Unauthorized / Forbidden / NotFound / InternalServerError
• AJAX 和普通请求返回不同格式

性能优化

快速开始

环境要求

• Go 1.20+
• SQLite3 驱动（纯 Go 实现，无需安装 C 依赖）

安装运行

# 安装依赖
go mod tidy

# 配置环境变量
cp .env.example .env

# 运行
go run cmd/server/main.go

# 或使用脚本
./run.sh        # Linux/Mac
run.bat         # Windows

构建

./build.sh
# 输出: school-app (或 school-app.exe)

默认账户

• 用户名：admin
• 密码：admin123

⚠️ 请在首次登录后立即修改密码！

环境变量

工具脚本

开发指南

添加新功能流程

1. 在 models/ 中定义数据模型
2. 在 repository/ 中实现数据访问层
3. 在 service/ 中实现业务逻辑
4. 在 handlers/ 中实现 HTTP 处理函数
5. 在 routes.go 中注册路由
6. 如需权限控制，使用 middleware.AuthRequired() 和 middleware.RoleRequired()

错误处理规范

c.Error(errors.BadRequest("错误信息", err))
c.Error(errors.Unauthorized("未授权", nil))
c.Error(errors.Forbidden("权限不足", nil))
c.Error(errors.NotFound("资源不存在", nil))
c.Error(errors.InternalServerError("服务器错误", err))

写在最后

项目一开始是用 Flask + SQLite 实现的，Docker 部署后发现资源消耗有点高，所以用 Go 重写。两个项目都是 AI 对话式写的。

核心价值

✅ Go 重写 Flask 项目 —— 降低 Docker 部署资源消耗的实战参考
✅ 分层架构 —— handlers / service / repository / models 清晰分层
✅ 权限控制 —— admin / user 双角色 + 中间件验证
✅ 安全特性 —— XSS 防护、SQL 注入防护、bcrypt 密码、安全 Cookie
✅ 纯 Go SQLite —— 无需 C 依赖，跨平台构建
✅ AI 对话式开发 —— 全程用 AI 辅助编写

适合谁？

• 学习 Go Web 开发的初学者（项目结构规范、分层清晰）
• Flask → Go 迁移的参考
• 高校信息管理系统的快速搭建

相关链接

• GitHub: https://github.com/Army-Mark/University-Information-Retrieval

Keywords: Go, Gin, SQLite, 高校信息查询, 全栈项目, 权限控制, Session认证, Flask迁移Go, 分层架构, 开源项目