本篇文章将列举使用过程中可能遇到的常见问题，并给出排查和解决方案。
涉及到安装以及使用可参考此文章
[https://bbs.halo.run/d/5819-%E4%BB%98%E8%B4%B9%E6%8F%92%E4%BB%B6%E5%BE%AE%E4%BF%A1%E5%85%AC%E4%BC%97%E5%8F%B7%E5%8F%91%E5%B8%83%E6%8F%92%E4%BB%B6%E7%9A%84%E4%BB%8B%E7%BB%8D%E5%92%8C%E4%BD%BF%E7%94%A8](https://)
建议阅读后再来查看本文内容。
1. 外部访问地址未填写问题
默认情况下会有一个初始的外部访问地址即 external url，值是 localhost:8090 ，但是正常使用插件不允许配置成 localhost，需要重新配置成网站可外部访问的域名，或者公网服务器IP+端口的形式。
如果需要重新配置，有两种常见的配置方式：
1Panel 部署方式：
应用商店 --> 选择 Halo 应用 --> 参数，然后编辑参数，找到外部访问地址，重新编辑保存即可。点击确认后，会提示重建应用，重建后刷新生效外部访问地址。
Docker 部署方式：
需要重建容器才能重新设置 external url 参数，请按如下顺序执行命令：
1、docker stop halo
2、docker rm halo
3、cp -r ~/.halo2 ~/halo2.archive
4、docker run -it -d --name halo -p 8090:8090 -e HALO_EXTERNALURL=XXX -v ~/.halo2:/root/.halo2 halohub/halo:2.9(版本号改成最新的)
注：
XXX 改成浏览器能访问的你的网站的地址
版本号改成目前的版本号
完成之后，卸载插件再重装，即可生效最新的 external url 外部访问地址。
2. 无法同步问题
在配置好了正确的外部访问地址，以及通过了密钥信息校验测试之后，可以进行文章的同步操作。如果遇到显示同步失败，可能是以下原因：
1、检查微信公众号的接口权限，是否获得永久素材管理的接口
2、网络原因。可能由于网络代理或安全策略等因素，导致 external url 无法通过浏览器访问。需要检查网络配置问题，比如代理、防火墙、安全组、白名单等，需要最终确保配置的 external url 可以通过浏览器正常访问。
3、文章配置原因。需要正确设置封面图，封面图的图片命名需要符合规范，不能有中文。还需正确勾选同步选项。
4、文章内容个别元素组件可能不支持，如某些特殊的代码块，特殊符号或者格式等。如果遇到无法同步成功的情况，不妨先除去文章内的此内容，测试同步功能正常之后，再逐个排查具体导致异常的文本片段。
