宝塔面板软件商店插件列表空白的解决方法包括：一、检查服务器网络连通性；二、重启宝塔服务并清除缓存；三、手动更新软件商店数据源；四、检查并清理hosts中bt.cn绑定；五、切换至国内镜像源。
如果您在宝塔面板中打开软件商店时，插件列表长时间显示空白或提示“加载中”，可能是由于网络连接异常、本地缓存错误、服务端接口响应失败或面板配置异常导致。以下是解决此问题的步骤：
一、检查面板服务器网络连通性
宝塔软件商店需从官方源（如 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 重载软件管理，并刷新浏览器页面。
