宝塔插件商店加载失败解决方法

当宝塔面板软件商店插件列表空白或卡在“加载中”时，问题通常源于网络不通、缓存异常、数据源失效、hosts劫持或官方源访问不稳定；本文系统梳理了五大高效解决步骤——从基础网络连通性检测、服务重启与缓存清理，到手动更新插件索引、修正hosts绑定，再到一键切换国内镜像源，每一步都直击常见故障根源，助你快速恢复软件商店正常功能，省去反复重装或盲目排查的时间。

如果您在宝塔面板中打开软件商店时，插件列表长时间显示空白或提示“加载中”，可能是由于网络连接异常、本地缓存错误、服务端接口响应失败或面板配置异常导致。以下是解决此问题的步骤：

一、检查面板服务器网络连通性

宝塔软件商店需从官方源（如 https://www.bt.cn ）拉取插件元数据，若服务器无法访问外网或 DNS 解析失败，则列表无法加载。

1、通过 SSH 登录服务器，执行命令：ping -c 4 www.bt.cn，确认基础连通性。

2、若 ping 不通，再执行：curl -I https://www.bt.cn，检查 HTTPS 连接与证书是否正常。

3、若返回超时或 connection refused，需检查服务器防火墙、安全组是否放行 443 端口，或是否存在代理/出口 NAT 配置阻断。

二、重启宝塔相关服务并刷新缓存

面板后台服务（bt、nginx）或本地前端缓存可能处于异常状态，导致接口请求未发出或响应被拦截。

1、执行命令重启宝塔主服务：bt restart。

2、等待约 10 秒后，执行：bt 16 清除面板运行缓存（该操作不删除数据，仅清空临时文件）。

3、登录面板后，**强制刷新浏览器页面**：Windows/Linux 按 Ctrl + Shift + R，macOS 按 Cmd + Shift + R，绕过本地 HTML/CSS/JS 缓存。

三、手动更新软件商店数据源

软件商店依赖固定 URL 获取插件索引（如 https://api.bt.cn/api/softlist ），若本地记录的源地址过期或被污染，将导致列表为空。

1、执行命令下载最新商店数据：curl -sS https://api.bt.cn/api/softlist > /www/server/panel/data/softList.json。

2、若提示权限拒绝，先修复目录权限：chown -R www:www /www/server/panel/data/。

3、执行命令重载商店模块：bt 19（该命令为“重载软件管理”功能）。

四、检查并替换 hosts 绑定记录

部分用户曾手动修改 /etc/hosts 将 api.bt.cn 指向错误 IP 或 127.0.0.1，导致接口请求被劫持或丢弃。

1、执行命令查看 hosts 中是否含相关条目：grep -i 'bt\.cn' /etc/hosts。

2、若输出非空，使用 vim 编辑：vim /etc/hosts，删除包含 bt.cn 的整行。

3、保存退出后，执行：systemctl restart systemd-resolved（如使用该服务）或直接重启网络服务：systemctl restart network（CentOS）或 systemctl restart systemd-networkd（Ubuntu/Debian）。

五、切换软件商店镜像源（国内用户适用）

官方源在国内偶发延迟或限流，可临时切换至宝塔提供的备用镜像节点以验证是否为源站问题。

1、编辑配置文件：vim /www/server/panel/class/common.py。

2、查找关键词 api.bt.cn，将其替换为：api.bt-mirror.com（注意保留前后引号和斜杠结构）。

3、保存后执行：bt 19 重载软件管理，并刷新浏览器页面。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《宝塔插件商店加载失败解决方法》文章吧，也可关注golang学习网公众号了解相关技术文章。