开发文档 ›全部章节 ›常见问题 ›常见报错排查

12. 常见报错排查

左边一栏是主程序或官网提交时的原话,遇到就对着查。

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

排查顺序建议:先用主程序后台「模板管理 → 导入模板包」或「插件管理 → 导入插件包」在本地试装, 能装上再交官网。本地装不上,交上来也是退回。

内容有问题去论坛发帖,或直接联系老李 QQ 260468289。