商品详情页可以加入购物车，但从收藏夹点击 Add to Cart 报错或跳回配置页面。收藏夹保存的是当时的 buy request；商品选项、可配置属性、网站分配或库存变化后，旧请求可能已不再合法。

固定复现条件

记录 wishlist_item_id、product_id、Store、buy_request 选项和当前商品配置。比较重新加入收藏夹的新条目与历史失败条目。

SELECT wishlist_item_id,wishlist_id,product_id,store_id,added_at,description FROM wishlist_item WHERE wishlist_item_id=123;
SELECT wishlist_item_id,product_id,code,value FROM wishlist_item_option WHERE wishlist_item_id=123;
SELECT entity_id,sku,updated_at FROM catalog_product_entity WHERE entity_id=456;
SELECT product_id,website_id FROM catalog_product_website WHERE product_id=456;
grep -RniE 'wishlist|BuyRequest|Please specify' var/log | tail -n 80

根据证据定位

缺失必选 option 或可配置子项已禁用时应要求重新配置；商品移出 Website 或不可售会拒绝；只有历史条目失败说明保存的 buy request 已过期。自定义 Option ID 重建后也可能失效。

修复与回滚

保留标准 Wishlist Item Option 结构，商品配置变更后给用户明确的重新配置入口。不要自动选择第一项绕过必选选项，也不要直接复制旧序列化值到 Quote。

验收

简单、可配置、Bundle、自定义选项和缺货商品分别测试；有效条目成功加入且数量正确，无效条目提示可操作原因，原收藏夹状态符合业务规则。

生产环境操作前的检查

处理“Magento 2 收藏夹商品无法加入购物车”前，先记录 Magento 版本、部署模式、问题 Store View、复现时间和最近发布。所有 SQL 默认先执行 SELECT；写操作、目录清理、服务重启和配置切换必须确认范围、保留备份并准备回滚。多节点环境还要核对构建版本、app/etc/env.php 配置摘要和实际流量节点。

php bin/magento --version
php bin/magento deploy:mode:show
php bin/magento maintenance:status
php bin/magento indexer:status
php bin/magento cache:status

命令应由 Magento 文件所有者在项目根目录执行。不要在生产高峰同时运行全量索引、静态部署和数据修复；涉及客户、支付、税费、库存或订单的变更，应先在脱敏数据副本验证。

建立可比较的排查记录

每次实验只改变一个变量，记录操作前值、命令、开始与结束时间、结果和回滚方式。至少准备一个正常对象和一个异常对象；旧对象恢复而新对象仍能复现，说明根因尚未消除。

检查层证据通过标准
入口 URL、状态码、请求 ID、节点 路由与协议一致
应用 异常堆栈、模块、作用域 无新异常且可重复
数据 主键、时间、关联行数 关系完整无重复副作用
业务 正常、失败与重试路径 最终状态一致

修复后的观察窗口

上线后至少观察一轮 Cron、队列和索引周期，并在两台节点、无痕浏览器与目标 Store View 重复验证。临时调试日志必须脱敏，确认错误率、响应时间和数据量稳定后及时关闭。