这个错误经常出现在删掉一个旧主题、切换分支或从另一台服务器恢复数据库之后。文件系统里已经没有主题目录，但数据库仍保留主题注册记录，或者商店配置仍指向旧的 theme_id。Magento 解析主题继承关系时找不到物理目录，最后只抛出 theme_dir 参数缺失。

先从异常栈里拿到theme id或theme path

不要一上来清整张 theme 表。先看 var/log/exception.log、部署命令输出以及错误前后的 theme 信息，再查询：

SELECT theme_id, parent_id, theme_path, theme_title, area, type, code
FROM theme
ORDER BY theme_id;

然后把 theme_path 与 app/design/frontend、app/design/adminhtml 下的实际目录逐一对上。还要检查 registration.php 和 theme.xml 是否在，文件夹存在不等于主题注册完整。

再查哪个scope还指着这个theme_id

SELECT config_id, scope, scope_id, path, value
FROM core_config_data
WHERE path = 'design/theme/theme_id';

如果旧主题 ID 只出现在某个 Store View，首页可能正常，而那个 Store View 一打开就报错。先明确 scope，不能只改 default 级配置。

主题本来就该存在，就把代码和依赖补回来

如果是发布漏文件或 Composer 包没有安装完整，正确处理是恢复主题代码，再运行：

php bin/magento setup:upgrade
php bin/magento cache:clean config layout

同时确认父主题也存在。只把数据库里的 parent_id 改成 NULL，虽然可能暂时不报错，但会破坏继承链，CSS 和模板随后会出现更隐蔽的问题。

确认主题已经下线，才清配置和注册记录

先在后台或配置表把相关 Store View 切到仍然存在的主题，再备份 theme 表，最后删除明确无用的那一条注册记录。不要按 theme_title 模糊删除，也不要清空整表。处理后清配置与 layout 缓存，再执行一次静态资源部署。

验证时除了前台，还要运行 php bin/magento setup:di:compile 或计划中的正式发布命令。因为有些残留只会在编译、静态资源收集阶段触发，浏览几个页面正常并不能证明主题注册已经干净。