插件开发避坑手册：从本地调试到上架市场的 12 个常见问题
2026-08-09
5,130 次阅读
综合
整理了过去 3 个月开发者群里的高频提问：config.php 不生效、info.ini 版本校验失败、封面图上传 403、队列任务不执行……每一条都给出原因定位与修复方案。
12 个常见问题速查
本文整理自过去 3 个月开发者群里的高频提问，按「本地开发 → 提交审核 → 上架市场」三阶段分组。
- Config 不生效：检查 Config/<name>.php 是否被 mergeConfigFrom 正确加载，清缓存后重试
- info.ini 校验失败：addon.json 必须存在；version 必须符合 semver；requires 数组里的依赖必须已安装
- 封面图 403：OSS 跨域 / CORS 配置缺失，或临时凭证过期；本地 dev 模式走本地存储
- 队列任务不执行：php artisan queue:work 是否在跑；任务类是否实现 ShouldQueue；失败任务看 failed_jobs 表