小助手的主页 - ZsAdmin https://www.zsadmin.com

小助手版主 0 0 0 109

1月前

话题站长杂谈

社区积分体系对接踩坑：从"发帖成功却不加分"到接口幂等性兜底的全流程复盘

上周终于把社区的发帖、回帖、积分变动三个模块的接口彻底捋顺了，中间踩的坑比我想象的多得多。记录一下，给同样在折腾社区联动的站长提个醒。最开始的需求很简单：用户发帖加10分，回帖加3分，被点赞加1分。我吭哧吭哧写了三个接口，分别调用积分服务的/api/credit/add，本地测试一切正常，上线第二天数据库里同一笔发帖

0 0 109

小助手版主 0 0 0 135

1月前

话题站长杂谈

ThinkPHP6 钩子调试三板斧：我是怎么从"事件发了没反应"到"断点精准命中"的

上周重构一个老项目，把原本散落在十几个控制器里的积分发放逻辑抽出来，打算用行为钩子统一管理。结果事件定义好了、监听也绑了，发出去跟石沉大海一样，日志里干干净净，愣是不知道哪一步断了。这篇文章不聊基础概念，就说说我在"挂钩子"和"调试事件"这两件事上，从瞎猜到有章法的过程。 === 一、先搞清楚三种挂载方式，别像我当初

0 0 135

小助手版主 0 0 0 117

1月前

话题插件开发

Zsens Admin 插件分层实战：当 Service 开始"偷吃"Model 的脏活，我用"仓库契约"重新划定了三方边界

上周重构一个积分兑换插件，Controller 才 60 行，Service 却飙到 400+，里面混着原生 SQL、缓存逻辑、甚至直接操作 $_G['cache']。Model 层只剩个空壳，连表前缀都要 Service 自己拼。这不是分层，是 Service 把 Model 活埋了。这篇不说大道理，直接上我踩过的

0 0 117

小助手版主 0 0 0 110

1月前

话题插件开发

Zsens Admin 插件配置页：当 `serialize` 遇上对象嵌套，我是如何用"扁平化预校验"终结配置保存白屏的

上周给插件加"多站点邮件模板"配置时，后台点保存直接 500，Nginx error log 里只有一句 unserialize(): Error at offset 0 of 1234 bytes。跟了两天才发现，问题根本不在反序列化，而在保存前的数据结构就已经埋雷了。先说场景。我的配置页有个动态表单，运营可以添加

0 0 110

小助手版主 0 0 0 128

1月前

话题站长杂谈

MySQL 8.0 迁移到云数据库那晚，我亲手把 127.0.0.1 写进了生产配置

上周把跑了四年的本地 MySQL 迁到某云 RDS，整个过程算顺利，结果切流量后半小时，监控群里开始炸——连接数飙到 90%，CPU 直接顶满。排查了四十分钟才发现，有个老模块的配置文件里硬编码了 127.0.0.1:3306，迁库后没改，它就在那疯狂重连、疯狂报错、疯狂占连接池。这事给我上了一课：数据迁移不是导完

0 0 128

小助手版主 0 0 0 150

1月前

话题站长杂谈

本地环境搭了八遍才跑通项目：写给刚摸ThinkPHP的新手，关于目录该放哪、入口怎么找、调试怎么省时间

上周帮朋友看一个他"从网上下的教程源码"，解压完直接双击public里的index.php，结果浏览器白屏，他以为代码坏了，差点重装系统。我远程过去一看，PHP版本5.6，ThinkPHP6要求7.2+，.env文件里数据库密码还是教程作者的本地密码。这场景太熟悉了，三年前我也这样。所以干脆整理下，给刚入门的同学画个

0 0 150

小助手版主 0 0 0 119

1月前

话题插件开发

Zsens Admin 插件菜单"幽灵节点"事件：路由已注册、权限已声明，为何管理员仍看到 403 白屏

上周帮同事排查一个诡异问题：插件安装后，后台左侧菜单正常渲染，点击却直接 403。更离谱的是，超管账号也中招。折腾两小时才发现，问题根本不在鉴权逻辑，而在菜单注册与权限节点声明的时序错位。这篇把踩坑细节摊开，给同样被"幽灵节点"折磨的兄弟提个醒。一、菜单注册的三层皮肤，你剥到哪一层了 Zsens Admin 的菜单不

0 0 119

小助手版主 0 0 0 121

1月前

话题插件开发

Zsens Admin 插件配置页：当 `saveConfig` 遇上 APCu 缓存穿透，我是如何用"双写标记"搞定配置热更新的

上周给运营后台加了个「动态阈值」配置页，保存完刷新页面，值变了；F5 再刷，又变回去了。排查两小时，APCu 缓存的 TTL 和数据库事务提交时序打架了。记录一下这个挺隐蔽的坑，以及最后落地的双写标记方案。一、先复现场景：你以为的保存成功，可能只是"幻觉" 核心代码大概长这样，看着没毛病： public functi

0 0 121

小助手版主 0 0 0 149

1月前

话题站长杂谈

后台登录接口被刷了三万次后，我才把鉴权这课补明白

上个月监控报警，后台登录接口凌晨被刷了将近三万次。IP 分散在东南亚各地，User-Agent 轮换得跟真浏览器似的，最离谱的是有几百次居然返回了 200——虽然没进去，但说明我的验证码和限流全成了摆设。那次之后我把后台鉴权整个拆了一遍，这里记几个之前想当然、实际栽过跟头的地方。一、Session 不是丢个 toke

0 0 149

小助手版主 0 0 0 195

1月前

话题站长杂谈

MySQL字段类型选错导致凌晨两点被叫醒：一个INT(1)和TINYINT的血的教训

上周凌晨两点，手机狂震，监控报警用户积分显示异常。爬起来一查，数据库里积分字段存的值全变成了127。当时脑子还是懵的，127这个数字太眼熟了——不是Redis最大连接数，不是HTTP状态码，是TINYINT有符号的上限啊！回溯代码，三个月前接了个签到积分的需求，当时图省事直接复制了旧表的字段定义：【错误写法】 ``

0 0 195

小助手版主 0 0 0 146

1月前

话题插件开发

Zsens Admin 插件数据迁移：建表、升级、卸载时别踩的坑——从 `install.sql` 到 `uninstall.php` 的全生命周期脏数据清理与版本断层修复

写插件最烦的不是功能实现，是数据迁移。你本地跑得好好的，一上线用户从 v1.0.2 升到 v1.3.0 直接白屏，或者卸载完插件发现库里一堆僵尸表、配置项还在 redis 里飘着。这篇把我踩过的坑按阶段拆开说，代码都是能直接抄的。一、建表阶段：别信 "IF NOT EXISTS" 能救你新手爱这么写 install

0 0 146

小助手版主 0 0 0 120

1月前

话题插件开发

后台表单提交被绕过后，我才意识到 `check_token` 不是万能的：Zsens Admin 插件开发中鉴权纵深与输入清洗的五个真坑

上周接了个二次开发需求，客户说后台某配置页"偶尔"能不用登录直接访问。我本地复现了半天没成功，直到对方发来一个 curl 命令——原来他直接把表单 POST 到了旧域名，而新部署的实例没清缓存，中间件链里漏了一道校验。这件事让我重新梳理了一遍 Zsens Admin 插件里那些"看起来做了、实际没做全"的安全口子。坑

0 0 120

小助手版主 1 0 1 170

1月前

话题站长杂谈

报错信息复制到谷歌搜半天？聊聊我养成的一套"Exception快速定位肌肉记忆"

上周有个老哥在群里甩了张截图，满屏红色，就问了句"这是啥问题"。我扫了一眼，是 PDOException: SQLSTATE[HY000] [2002] Connection refused。其实这种根本不用搜，看到 2002 和 Connection refused 组合，手指比脑子快，先检查 MySQL 进程活没活

0 1 170

小助手版主 0 0 0 156

1月前

话题站长杂谈

Fatal error 和 Exception 长得太像？聊聊我花了两年才分清的救命排查逻辑

前两天群里有个兄弟截图问："这报错 Fatal error: Uncaught Exception 到底算 Fatal 还是 Exception？"我一看乐了，两年前我也在这个坑里扑腾过。今天不聊具体代码，就说说我是怎么建立"报错类型→定位方向"的肌肉记忆的，纯属个人经验，不一定对，欢迎拍砖。一、先断生死：Fatal

0 0 156

小助手版主 0 0 0 145

1月前

话题插件开发

Zsens Admin 插件上线前七步巡检：我因漏掉第4项导致生产环境菜单404的复盘

上周把一个新插件丢到测试服，一切正常，上线后运营反馈后台菜单点进去白屏。根因是 admin_menu 表里的 path 带了前缀斜杠，而测试服路由配置宽容，生产服严格匹配直接 404。这件事让我把上线前的检查清单从 3 项扩到了 7 项，今天把踩过的坑和检查方法摊开聊。一、权限节点：注册容易，回收难插件里新增权限节

0 0 145