跳到主要内容
万能墙开放平台
插件开发教程

常见问题排查

全部内容基于万能墙真实的插件平台(清单 + 钩子 + 接口 + 后台页 + 数据 + 定时任务),示例可直接复制运行。

插件不加载

1. 路径对不对:backend/plugins/<slug>/plugin.php(多一层目录就不认);

2. plugin.json 是不是合法 JSON(用 php -r 'var_dump(json_decode(file_get_contents("plugin.json")));' 看一下);

3. 后台插件列表里状态是不是「已启用」;

4. 有没有被熔断:插件管理页看故障原因,点「清除熔断」。

钩子没生效

  • addFilter 必须 return 值;只 return 不 echo、只 echo 不 return 都不对;
  • 钩子名拼写:对照「扩展点清单」,注意是 plugin_render_footer 而不是 footer;
  • 注册代码必须在加载时就执行(不要包在 if (isset($_GET[...])) 里);
  • 页面可能被整页缓存:先强刷(Ctrl/Cmd + Shift + R)。

接口返回 405 / UNKNOWN_ACTION

  • 405:方法不匹配(写接口用 POST;读接口要声明 'method' => 'GET');
  • UNKNOWN_ACTION:路由没注册上 —— 检查插件是否启用、action 名是否合法(小写字母/数字/下划线)。

数据库报错 no such table

安装钩子没跑或没建表。在 onInstall 里调用 pluginCreateTable(),并在入口文件里也做一次幂等 ensure(老站点升级时可能不会重新触发安装)。

中文乱码 / JSON 解析失败

文件保存为 UTF-8 无 BOM;json_encode 时加 JSON_UNESCAPED_UNICODE。

提交被拒:包结构不合法

常见原因:zip 里多了一层文件夹、没有 plugin.json、缺 plugin.php、版本号带 v 前缀(应写 1.0.0)、超过 8MB、包含 .mp4/.exe 等被禁止的文件。

想改已上架的版本号怎么办

不能覆盖已发布版本。递增版本号提交新版本,旧版本会保留给已经安装的站点升级用。

我的插件能不能收费

目前市场只做「审核上架 + 一键安装」,不支持支付。商业化需求可以先在插件页留项目主页。