12. 常见报错排查
左边一栏是主程序或官网提交时的原话,遇到就对着查。
| 提示 | 原因与处理 |
|---|---|
不是有效的 zip 压缩包 | 包不是 zip,或者上传断了 |
安装包太大 (上限 20MB) | 超过 Package 的硬上限 |
包内文件太多 (上限 3000 个) | 把 node_modules 之类一起压了 |
解压后体积超过上限 (64MB) | 小 zip 解压出巨型文件 |
包内含非法路径:xxx | 压进了绝对路径或 .. 上跳目录 |
包内文件名含非法字符:xxx | 文件名里有尖括号、冒号、星号等 |
包里发现多个模板根目录,请一次只打包一个模板 | 压了两个模板,或压了整个 templates |
包根目录不唯一,请把模板目录整体压缩成一个根目录 | 根目录外面还散着文件 |
包里没有找到 Dtr.php,不是有效的模板包 | 标记文件缺失或压深了 |
Dtr.php 内容为空 | 文件是空的或编码带 BOM 出问题 |
无法确定模板目录名,请在 Dtr.php 里写好 name | Dtr.php 里没 name 或者值不合规 |
包里的应用名是「xxx」,和官网标识「yyy」对不上,为防装错目录已中止 | 标识 ID 和包里的 name 不一致 |
模板包不完整:至少需要 Dtr.php、views/index.php、views/layout.php | 首页视图或外壳缺失 |
plugin.json 格式错误 (需要 JSON 对象) | 写了注释、用了单引号、多尾逗号 |
plugin.json 的 name 只能包含字母、数字、下划线和短横线 (1-40 位) | 目录名写成了中文或带空格 |
插件入口文件不存在:xxx | entry 写的文件名和包里的对不上 |
plugin.json 的 class 不是有效的 PHP 类名 | 类名写错或漏了命名空间 |
开启前先开启它依赖的插件:「xxx」 | deps 里的插件装了但没开 |
本插件依赖的「xxx」还没安装,请到「插件管理 → 导入插件包」上传该插件的 zip 再开启 | deps 里的插件根本不在站点里 |
模板不存在:xxx | 视图文件名写错 |
模板渲染错误:xxx | 视图里 PHP 报错了 |
插件「xxx」缺少页面:yyy | renderFront 的文件名和 views 下对不上 |
这个 zip 打不开,多半是上传断了或者不是真 zip | 官网提交时的预检 |
这件应用既不在你账号的已购清单里,也不是免费商品:先在官网下单 | 令牌下载被拦 |
排查顺序建议:先用主程序后台「模板管理 → 导入模板包」或「插件管理 → 导入插件包」在本地试装, 能装上再交官网。本地装不上,交上来也是退回。
内容有问题去论坛发帖,或直接联系老李 QQ 260468289。