# 插件装完没报错，功能却“装死”：从一次安装脚本没跑完说起

上周帮朋友排查一个插件问题：后台显示“安装成功”，插件列表里状态是“已启用”，但前台该出现的入口一个都没有。没有报错，没有白屏，日志干净得像什么都没发生过。这种“静默失效”比直接抛异常更难查——因为你的第一反应是“代码写错了”，但实际上问题可能出在安装那一刻。

这篇不讲路由注册、不讲钩子挂载，那些前面已经聊透了。今天只聚焦一个更靠前、也更容易被跳过的环节：插件的安装脚本到底有没有完整执行完。

先确认一件事：你以为的“安装成功”可能只是“文件复制成功”

很多 BBS 或 CMS 的插件机制里，“安装”其实包含两个独立动作：文件落盘 + 执行 install 脚本（建表、写配置、注册权限节点、初始化默认数据）。后台那个绿色的“安装成功”提示，有时只代表文件解压到位了，install 脚本可能因为权限、SQL 兼容性、执行超时等原因中途断了，而框架没有把失败状态透传到界面上。

所以排查的第一步不是看代码，是看数据库里该建的表建了没有、该写的配置项写了没有。拿 phpMyAdmin 或命令行直接查：插件相关的表是否存在？prefix_config 里有没有这个插件的配置记录？权限节点表里有没有对应条目？如果这些“安装产物”缺失，那问题根本不在运行时代码，而在安装阶段就断了。

安装脚本没跑完的三个典型断点

断点一：SQL 语句在严格模式下被拒。本地开发环境 MySQL 可能是宽松模式，线上是严格模式。install.sql 里某个字段没给默认值、或者用了保留字做列名，本地跑得好好的，线上直接报错中断。但框架捕获了异常只写进日志，前台只显示“安装完成”。查法是手动把 install.sql 拆成单条逐句执行，看哪一句炸。

断点二：配置文件写入权限不足。有些插件安装时会往 config 目录写一个专属配置文件，如果该目录对 Web 进程用户不可写，写入静默失败，后续代码读不到配置就走默认分支——而默认分支往往是什么都不做。查法是安装后立刻去看目标配置文件的时间戳和内容，别信“成功”提示。

断点三：安装脚本里的钩子注册代码依赖了尚未存在的类。install 阶段可能调用了插件主类的某个静态方法去注册钩子，但如果自动加载顺序不对，这个类还没被载入，调用就失败了。失败被 try-catch 吞掉，钩子没注册上，运行时自然不触发。这种最隐蔽，因为文件都在、表也建了，就是钩子列表里少一项。查法是安装后打印当前已注册的钩子数组，跟预期比对。

一个可复用的验证顺序

与其每次装完靠猜，不如固定一套检查动作：先查表，再查配置项，再查权限节点，最后查钩子注册列表。这四样是安装脚本的典型产物，任何一样缺失都说明安装没走完。确认产物齐全之后，再去怀疑运行时逻辑。顺序反了，就会在代码里绕很久，最后发现是安装那一步就没铺好路。

另外建议在开发插件时，把 install 脚本的每一步都加上明确的日志输出，别依赖框架的“成功”提示。自己写的日志不会骗你。

你遇到过装完没报错但功能死活不生效的情况吗？最后是在哪一步找到根因的？