常见问题
遇到了什么问题,可以先来这里查找,如果没有找到,请提 issues: Github
常见问题与解决方案
1、附件无法下载,去哪里获取?
答:加 uni-halo 交流群,群号 632969367,群里有相关的素材可以下载,还可以在线交流。
2、配置图片防盗链后微信小程序图片无法访问?
答:在防盗链的白名单中加入 servicewechat.com,这个链接是微信官方的地址,可以放心添加。
text
servicewechat.com3、本地运行时报接口请求失败?
答:请检查 env/.env 中的 VITE_SERVER_BASEURL 是否指向你自己的 Halo 后端地址(默认 http://localhost:8090),并确认后端已启动、且已安装并启用 uni-halo 配置插件。微信小程序真机预览需要 https 域名,可先使用开发者工具并勾选「不校验合法域名」。
4、Node 版本有要求吗?
答:有,要求 Node >= 20、pnpm >= 9,旧版本可能会导致依赖安装或构建失败。
5、支持哪些平台?
答:源码理论支持编译为微信小程序(推荐)、APP、H5 等多端;目前主要维护与测试的平台为微信小程序。
6、页面提示「插件不可用」或某一块内容空白?
答:该功能依赖的 Halo 插件没有安装或启用。图库、瞬间、搜索、友链、投票、数据看板、评论分别对应各自的插件,请到 Halo 后台 插件 中确认状态,完整清单见 插件配置 - 安装插件。
更多常见问题待补充...


