上周我把自己那台Home Assistant从旧版本升到了2026.2.3重启完点开页面第一个反应就是我的加载项呢左侧栏的“加载项”图标没了设置里翻了好几层也没找到群里问了一圈同样懵的人不在少数。有人说是升级回退了有人说要去Docker里重新部署还有人说干脆重装系统算了。我把所有可能的原因挨个过了一遍折腾了一晚上才弄明白——加载项不是“丢了”而是入口改了、商店源断了、Supervisor状态异常这三件事在叠加捣乱。这篇文章就把我排查“homeassistant新版本加载项找不到”的完整过程写出来基于我自己这边的2026.2.3版本如果你的界面细节和我描述的不完全一样灵活对应就行。内容会覆盖什么情况下你的HA压根没有加载项、新版加载项入口到底藏在哪里、商店空白怎么恢复、Supervisor不健康怎么处理、内网环境下该怎么办。每个原因都配了检查方法和解决步骤照着做基本能在十分钟内定位问题。适合刚升级新版本一脸懵的朋友也适合一直搞不清“为什么别人有加载项我没有”的玩家参考。1. 加载项“消失”之前先确认你的HA有没有资格拥有加载项很多人的问题其实不是“版本更新后加载项丢了”而是从装好的第一天起这台HA就从来没有加载项商店。这个前提不搞清楚后面所有排查都是在浪费时间。1.1 加载项是由Supervisor提供不是HA核心自带的先说点背景知识。Home Assistant本体管的是设备接入、自动化、仪表盘这些事它本身不包含“应用商店”。真正的应用商店是另一个叫Supervisor的系统组件在管加载项本质上就是Supervisor帮你拉取、启动、守护的一群Docker容器。界面上的“加载项”页面说白了就是Supervisor的前端展示。所以只要Supervisor没装、没启动、或者状态不健康加载项商店要么根本不存在要么打不开、要么列表全空。这个认知是所有排查的骨架。1.2 四种安装方式只有两种自带加载项HA官方有四种安装形态能不能用加载项商店在安装那一刻就决定了安装方式是否自带Supervisor加载项商店典型场景HAOSHome Assistant Operating System自带有官方盒装、虚拟机镜像、树莓派官方镜像Supervised监督版需要单独安装有在Debian等Linux系统上手动部署ContainerDocker容器没有没有群晖、威联通、软路由上跑DockerCorePython/venv没有没有极少数的源码级部署很多在NAS上用Docker拉镜像安装的朋友App显示的是“Home Assistant Container”那你的系统结构里天生没有Supervisor所以2026.2.3里找不到加载项入口这是正常的不是你哪里设置错了也不是版本升级的锅。1.3 怎么快速判断自己属于哪种安装方式最快的方法是打开“设置 → 系统”看看页面上有没有“Supervisor”这张卡片。有说明你的HA带Supervisor加载项应该存在没有基本就是Container或Core部署。更准确的确认方式打开“设置 → 关于”看Installation Type这一行写的是什么。如果能看到“HAOS”或“Supervised”加载项功能就是可用的。如果写的是“Container”那就别在界面里找加载项了。如果你是走的Supervised路线但升级到2026.2.3后突然没有加载项入口了那才是需要继续往下排查的情况——很可能是Supervisor服务挂了或者入口被新版界面藏起来了这正是后面几章要解决的问题。1.4 我见过最多的一种“假性消失”场景有个朋友在群晖上跑了两年HA一直以为“加载项”是所有人都有的东西。有一天看到别人分享Node-RED的加载项配置他兴冲冲去自己的HA里找死活找不到然后来问我是不是更新坏了。我远程看了一眼“关于”页面Installation Type写得清清楚楚Home Assistant Container。他之前的HA版本里侧边栏可能确实有个“Supervisor”或“加载项”入口的残影但点进去也是空壳。这类问题不是版本兼容问题而是当初的安装选型问题。如果你正好是这种情况又确实想把加载项用起来唯一的正路是迁移到HAOS或Supervised部署不要想着在Container里手动拼一个商店出来折腾半天还不稳定。2. 2026.2.3把入口挪了加载项实际藏在设置里面如果你确认自己的安装方式是HAOS或Supervised那升级到2026.2.3后找不到加载项大概率是新版UI改了导航结构。我这次就属于这个情况。2.1 新旧入口的直观对比旧版本里左侧栏有一个固定的“加载项”图标点进去就能看到“已安装”和“商店”两个区域非常显眼。2026.2.3这次把导航重新整理了一轮加载项不再单独占一个侧边栏入口了而是收进了“设置”的层级里面。我刚开始也以为是被精简掉了后来才发现它只是换了位置。新版里有两个都能到达加载项页面的路径我用下来都比较顺畅。2.2 我实测的进入路径路径一打开“设置”。进入“设备与服务”。页面顶部有几个标签页其中一个就是“加载项”。点进去之后右上角的按钮可以打开“加载项商店”。路径二打开“设置”。进入“系统”。点击“Supervisor”卡片。在Supervisor的管理界面里左侧或顶部会有“加载项”入口。第二条路径是我的兜底方案因为这里直接对应的是Supervisor本体只要Supervisor活着这个页面肯定在。如果你在“设备与服务”里找不到加载项标签多半是界面缓存的残影切到Supervisor页面再进基本都能看到。2.3 把加载项固定回侧边栏的小技巧旧版那种“左侧直接点”的体验确实方便新版里其实还能找回来。进入任意一个加载项的详情页在配置区域通常有一个“在侧边栏显示”或“显示在侧边栏”的开关把它打开这个加载项就会重新出现在左侧栏。比如我常用的Node-RED、Terminal这类加载项我都手动固定了日常操作跟旧版一样顺手。不过这个开关是针对单个加载项的它恢复的是“单个加载项入口”不是整个商店入口。商店入口本身我还是建议直接记住“设置 → 设备与服务 → 加载项”这条路径。2.4 新手最容易漏掉的“高级模式”开关2026.2.3里还有一个隐藏条件左下角用户头像点进去有一个“高级模式”开关。如果你没有打开这个开关加载项商店里的一部分特殊加载项是不显示的比如SSH Web Terminal、一些调试工具这类偏底层的加载项会被藏起来。这个开关是按用户生效的不是开一次全家通用。假设你家里有三个用户账号只有开了高级模式的账号能看到完整商店列表。我排查时差点被这个坑绊倒建议你第一时间就把它打开反正开了也没有副作用。3. 商店空白才是重灾区仓库源丢了和源断了如果你已经进入了加载项商店页面但里面空荡荡一直转圈或者列表只有一部分、官方加载项全不见了那问题集中在“仓库源”这一层。这是我在2026.2.3上踩得最狠的一个坑。3.1 加载项商店的底层机制仓库即列表加载项商店不是一个静态页面它的内容来自一个个Git仓库。每一个仓库里放着一批加载项的描述文件、图标、版本信息Supervisor启动时会去这些仓库拉取元数据然后拼出你看到的商店列表。所以商店空白只有两种本质原因仓库源没配置或者仓库源拉不下来。前者是配置问题后者是网络问题。官方仓库现在主要拆成了两个正式版仓库https://github.com/home-assistant/addons测试版仓库https://github.com/home-assistant/addons-edge其中正式版仓库又按目录划分了core、essentials等不同类别但你不需要手动分目录添加只要把这个根地址加进去Supervisor会自己解析里面的结构。3.2 恢复官方仓库的实操步骤在“加载项商店”页面右上角或者右上方的“···”菜单里能找到“仓库”管理入口。操作流程如下打开仓库管理页面你会看到当前已添加的仓库列表。如果列表里没有任何官方地址点“添加”按钮。把https://github.com/home-assistant/addons粘进去保存。等Supervisor拉取完成商店里应该立刻多出几十个官方加载项。如果你需要一些还没有进入正式版的新加载项可以再加https://github.com/home-assistant/addons-edge但建议普通用户只加正式版一个就够。保存之后如果商店还是空白不要急着反复添加先看下面的网络原因。3.3 为什么升级到2026.2.3后商店源会“自己消失”老实说官方仓库源不会因为你升级版本就被自动删除但有几个场景会让商店看起来像被清空了。第一种你之前添加过第三方GitHub仓库而这些仓库由于作者弃坑、改名、仓库被删等原因已经失效。升级之后Supervisor做了一轮仓库和加载项兼容性清理失效源会被标记或移除导致原来能显示的加载项大范围消失。第二种Supervisor的仓库缓存损坏。升级过程中如果强制断电、容器重启异常缓存目录里的仓库元数据可能残缺表现出来就是商店只能加载一半甚至完全空白。第三种登录凭证或网络变化导致Supervisor暂时无法访问GitHub。这种情况通常不是永久性的刷新几次或者重启Supervisor就能恢复。3.4 内网环境下加载项商店为什么必然空白这里专门说一下内网环境。很多人把HA部署在公司内网或家里的隔离网络里物理机只能访问局域网出不了公网。而加载项商店从设计上就要访问GitHub内网环境天然拉不动仓库页面就会一直停留在“加载中”状态过一会儿报超时。判断是不是这个问题可以打开“设置 → 系统 → Supervisor”页面里的日志看到类似连接github.com超时、TLS握手失败之类的记录基本就是出网受阻了。可行的解法我实测过两种在内网搭一个Git仓库服务比如Gitea把官方仓库完整镜像一份到内网然后在HA的仓库管理里添加“内网仓库地址”让Supervisor从内网拉取。适合长期隔离网段、运维能力比较强的场景。在有公网访问能力的机器上把需要的加载项文件准备好再通过“上传”或手动部署方式塞进Supervisor。这个门槛相对高一些普通用户不建议硬刚优先解决HA主机的出网能力更省事。有一点得强调如果内网环境是临时性网络限制那等网络恢复后商店通常会自己好如果是长期隔离网络那就老老实实走内网仓库镜像方案别在界面里反复点刷新没有用。3.5 时间同步和DNS这两件小事经常被忽略仓库拉取走的是HTTPSHTTPS证书验证依赖系统时间的正确性。如果你的HA主机时间漂移了好几年Supervisor请求GitHub时证书验证必然失败商店的表现也是空白或加载失败。日志里如果出现“certificate verify failed”这种关键词先别怀疑源直接检查主机时间。HAOS系统可以在宿主机上执行timedatectl看当前时间和NTP状态。如果NTP没开执行timedatectl set-ntp true开启自动同步。DNS解析失败也会导致仓库拉不下来表现为Supervisor日志里有“Name or service not known”。这时候把HA主机的DNS改成公共DNS或者内网可靠的DNS服务器再试。4. Supervisor不健康加载项“不可用/被禁用”的幕后黑手入口找到了仓库源也正常但点开加载项列表发现所有加载项都灰着状态写着“不可用”或者商店按钮是灰色点不动。这种情况和“找不到入口”是两码事更像你搜到的“加载项被禁用”那种状态——在HA里它通常是Supervisor整体不健康导致的。4.1 健康状态的和检查入口在2026.2.3里Supervisor有一个“系统运行状况”页面路径是“设置 → 系统”在“系统”这个标签页里能看到当前系统的健康检查结果。如果Supervisor状态是红色的“不健康”那加载项列表出现异常就一点也不奇怪。健康检查覆盖的东西挺多磁盘使用率、内存占用、DBus服务、AppArmor配置、Supervisor版本、网络连通性等。任何一个大幅异常都可能让Supervisor拒绝正常调度加载项容器。4.2 磁盘满是最常见的元凶我遇到过很多次“加载项全部不可用”的情况八成是宿主机的磁盘满了。加载项本身是Docker容器日志、镜像、备份文件都非常吃磁盘。HA的备份功能如果开了自动备份备份文件会存在本地时间一长几十个GB就没了。检查方法在“系统运行状况”页面看存储条的剩余空间。SSH到宿主机执行docker system df看镜像和容器日志占了多少。清理积压的HA历史备份尤其是自动备份策略生成的那些旧文件。执行docker system prune清理无用悬空镜像和缓存。清理完磁盘空间后到Supervisor页面重启一下Supervisor加载项通常能恢复运行状态。4.3 Supervisor日志怎么排查如果磁盘没问题那就得看日志了。“设置 → 系统 → Supervisor”页面里右上角一般有日志按钮。我从日志里最常见的几类错误给你列一下日志关键词代表问题优先处理方向dbus/gdbus宿主机DBus通信异常检查宿主机的dbus服务是否运行apparmor内核安全模块加载失败检查AppArmor配置或重装Supervisorcertificate verify failed时间不同步或证书问题先同步时间再检查系统时钟timeout/Connection timed out网络出网受阻查DNS、路由、内网防火墙MemoryError/Cannot allocate memory内存不足考虑扩大内存或关掉部分加载项4.4 修复手段分成四个级别我按破坏性从小到大的顺序给你排一排在“设置 → 系统”页面右上角点“重启”重启整个HA核心让Supervisor重新建立和加载项之间的通信。在Supervisor管理页面单独重启Supervisor服务或者把出现异常的加载项点“停止”再“启动”。如果重启解决不了“设置 → 系统 → Supervisor”里有一个“修复”或“重新加载”按钮这个动作会重新评估当前环境并尝试修复Supervisor自身的状态。最后一招才是备份数据后重刷系统。尤其是使用第三方脚本在Docker里装的Supervisor一旦环境依赖破损重装Supervisor比排查半天更省事。我个人建议是不要一上来就用第四招先做低破坏性的重启和修复。2026.2.3里Supervisor和加载项的耦合度比旧版更高很多问题重启一次就好了。5. 两个隐蔽小坑浏览器缓存和App端登录态还有一个非常容易被忽略的洼地跟你的HA服务端没关系纯粹是浏览器或App端的问题。我排查时一度以为自己配置全错了最后发现只是缓存和登录态作祟。5.1 升级后页面“还是旧的”强制刷新和无痕模式界面导航改版后浏览器里缓存的JS和CSS资源可能还是旧版的。你开着原来的标签页刷新几十次看到的还是旧侧边栏或者新版菜单时隐时现。这不是Bug是缓存没更新。处理方式在加载项页面按CtrlShiftR做一次强制刷新。或者复制当前网址打开一个无痕窗口粘贴进去。无痕模式默认不用旧缓存如果无痕窗口能正常显示加载项入口那就是缓存问题。清一次浏览器站点数据再重新登录连登录态一起刷新。5.2 Token失效导致权限异常HA长时间不登录、或者升级后用户会话过期可能出现一种现象页面能开数据能看一部分但“加载项商店”按钮点了没反应或者提示无权访问。这不是你没权限而是access token早失效了前端还在拿旧token发请求。处理很简单退出当前登录账号重新登录一次。如果之前开启过高级模式重新登录后确认一下高级模式开关还在不在。5.3 手机App和网页端“不一致”的怪状我在2026.2.3上还遇到一个现象手机浏览器访问HA一切正常加载项入口都在但Android/iOS的Home Assistant App里死活找不到新版加载项入口。这是因为移动端App有自己的一套资源缓存更新频次跟网页端不同步。通用解法在App的加载项页面往下拉触发一次下拉刷新。清掉App的WebView缓存路径一般在设置里找“清除缓存”。实在不行就卸载重装App。重装之后重新登录基本能对齐到新版界面。如果你手机端和网页端都找不到那就回到前几章的内容从安装类型和Supervisor状态重新过一遍。6. 我的十分钟排查清单从最可能到最冷门最后我把这次踩坑总结成一张可以直接照着做的排查清单。遇到“homeassistant新版本加载项找不到”按这个顺序走大多数人在前几步就能解决问题。观察到的现象最可能的原因对应处理左侧栏从来没看到加载项入口“关于”里显示Container安装方式不带Supervisor无法直接获得加载项需迁移到HAOS/Supervised左侧栏入口消失但“设置 → 系统”里有Supervisor卡片新版UI改动入口位置走“设置 → 设备与服务 → 加载项”或“设置 → 系统 → Supervisor”商店列表空白一直转圈仓库源丢失或网络不通添加官方仓库地址检查内网、DNS、时间同步所有加载项灰色状态是不可用Supervisor不健康或磁盘满查“系统运行状况”清理磁盘重启Supervisor网页端正常App端异常App缓存和WebView问题下拉刷新、清缓存、重装App商店能打开但部分加载项缺失高级模式没开或第三方源失效打开高级模式仓库管理里清理失效源排查时有一个小原则先把“没有Supervisor”的情况排除再谈“入口找不到”然后是“商店白屏”最后才轮到“Supervisor不健康”。顺序反了会浪费很多时间。这次我自己遇到的就是“入口改版”和“仓库源失效”两个坑叠在一起左侧栏空、商店也空看起来像整个加载项系统被删了。后来我打开“设置 → 系统 → Supervisor”这个底层入口发现Supervisor活得挺好就明白是表面导航的问题再从仓库管理重新加入官方源商店立刻恢复了。给你一个经验性的收尾在新版本里如果加载项找不到先不要急着重装系统。所有和加载项相关的东西都归Supervisor管而Supervisor的状态在“设置 → 系统 → Supervisor”里一定能看到。以这个页面为锚点对比我上面的排查清单一层层查下来大概率能在几分钟内定位到真正的原因。以后HA再升级我也会把这个流程当默认操作毕竟加载项这套体系才是HA真正好用的灵魂所在。