thinkphp在线教育系统开发需避开路由错位、模型外键未显式声明、小程序session无法复用、缓存未及时清除及事务边界遗漏五大坑;须分组配置api/后台路由、显式指定hasmany/belongsto外键、改用jwt替代session、统一缓存tag管理、模型操作显式加入事务。

直接上手 ThinkPHP 在线教育系统开发,关键不是选框架,而是避开几个高频掉坑点:路由配置错位、模型关联漏写、缓存未清导致前台不更新、小程序端 session 无法复用。这些不是“理论问题”,是部署后立刻卡住你上线的实操障碍。
ThinkPHP8 路由定义必须区分后台和小程序 API
很多人把 admin/ 和 api/ 全塞进同一个路由组,结果小程序调用 /api/course/list 时被中间件重定向到登录页——因为没单独配置跨域和无 session 认证规则。
- 后台管理接口走
Route::group(['prefix' => 'admin', 'middleware' => ['checkLogin']]...),依赖 session - 小程序/H5 前端接口必须走独立分组:
Route::group(['prefix' => 'api', 'middleware' => ['cors', 'jwt.auth']]),禁用 session,改用 token 验证 - 别在
route/app.php里混写;ThinkPHP8 推荐按模块拆成route/api.php和route/admin.php,否则后期加微信登录回调时容易冲突
课程与章节模型关联必须显式声明 foreign_key
ThinkPHP 的 hasMany 默认按 “当前模型名_id” 推导外键,比如 CourseModel 关联 ChapterModel,它会自动查 course_id 字段——但如果你数据库字段叫 courseid 或 cid,列表就永远为空,且不报错。
- 在
app\model\Course.php中,必须写明:return $this->hasMany(Chapter::class, 'cid'); - 同理,
Chapter模型反向关联视频时,若字段是video_id,不能只写$this->belongsTo(Video::class),得补全:$this->belongsTo(Video::class, 'video_id') - 调试技巧:用
dump($course->chapters->toArray())查数组是否为空;如果为空但数据库明明有数据,第一反应就是查外键名是否匹配
小程序端登录态无法保持?别碰 Session,改用 JWT
UniApp 小程序发起请求时默认不带 cookie,session_start() 生成的 PHPSESSID 根本传不过去。硬要在中间件里开 session_id() 强制读取,会导致并发下用户串号。
- 放弃
think\facade\Session,改用think\facade\Cache+ JWT:登录成功后生成 token,存入 Redis(key:token:{md5($uid)}),过期时间设为 7 天 - 小程序每次请求带上
Authorization: Bearer xxx,自定义中间件app\middleware\JwtAuth.php解析并校验 token,再从 Redis 取出 uid 注入Context::set('uid', $uid) - 注意:JWT payload 里别塞敏感字段(如手机号),只放
uid和exp;签名密钥必须存在环境变量JWT_SECRET中,别写死在代码里
缓存失效不及时?别只清模板,要连带清查询缓存
管理员在后台修改了课程标题,H5 页面刷新后还是旧内容——大概率是用了 Cache::remember() 查课程列表,但更新课程时没主动删缓存 key。
- ThinkPHP8 的
Db::table('course')->cache(true)->select()会自动生成缓存 key,但更新操作不会自动失效它 - 在
CourseController::update()最后加一句:Cache::tag('course_list')->clear();,前提是你在查询时用了->cache('course_list', 3600) - 更稳妥的做法:所有课程相关缓存统一打 tag,如
course_{$id}、course_list、course_hot,更新单条时删对应 tag,批量操作后删整个coursetag
最常被跳过的其实是数据库事务边界——比如购买课程时要扣余额、生成订单、更新课程销量、发通知,四个动作缺一不可。但很多人只在控制器里用 Db::startTrans(),却忘了模型层的 save() 方法默认不参与事务,得手动传 ['transaction' => true] 进去。这点不验,上线后对账就会发现钱少了、课没买成。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











