setup:upgrade 卡住时要判断是在执行补丁、等待 metadata lock 还是处理大表。贸然 kill 可能留下更难恢复的半完成状态。
继续阅读Magento 2 setup:upgrade 一直不结束，先别急着 kill 进程
2025/7/24 下午2:48
alwayly
Magento 2 Composer Patch 显示 applied，代码为什么还是旧的？
2025/7/25 上午10:33
alwayly
补丁工具显示 applied 不代表运行中的容器使用了修改后的 vendor。要检查目标包版本、构建产物、OPcache 和多节点一致性。
继续阅读Magento 2 写了 preference 却完全不生效，问题通常不在 cache
2025/7/28 下午3:22
alwayly
preference 不生效时先确认 area、接口与实际实例，再看配置合并和生成代码。反复清缓存往往只是浪费时间。
继续阅读Magento 2 Plugin 执行顺序不对，before、around、after 到底怎么排？
2025/7/29 上午9:46
alwayly
Plugin 顺序异常要看同一 area 的合并配置、sortOrder、around 是否调用 proceed，以及目标方法能否被拦截。
继续阅读Magento 2 REST Token 明明没过期却返回 401，应该从哪里查？
2025/7/30 下午1:18
alwayly
REST 401 不只和 token 过期有关。先确认 Authorization 是否到达 PHP，再区分 token 类型、ACL、网站 URL 和反向代理。
继续阅读Magento 2 REST 报 Request does not match any route，路由明明写了为什么找不到？
2025/7/31 上午10:11
alwayly
路由找不到时按 HTTP 方法、URL 前缀、webapi.xml 合并结果和服务接口逐项核对，不要先怀疑控制器。
继续阅读Magento 2 重建索引后搜索仍然搜不到商品，别只重复 reindex
2025/8/1 下午2:02
alwayly
reindex 成功只说明任务结束。商品能否被搜索还取决于网站分配、可见性、库存、属性配置和搜索引擎中的实际文档。
继续阅读Magento 2 客户登录后又跳回登录页，Cookie Domain 应该怎么排？
2025/8/4 上午9:31
alwayly
登录循环要同时看 Set-Cookie 与下一次请求 Cookie，重点检查域名、Path、Secure、SameSite、Base URL 和代理协议头。
继续阅读Magento 2 Checkout 显示的总价和最终订单不一致，怎么找出是谁改了 Totals？
2025/8/5 下午3:36
alwayly
结账页与订单金额不一致，要按 Quote collectTotals、前端 totals、支付请求和订单转换四个时间点对账，找到第一次分叉。
继续阅读Magento 2 开启 CSP 后支付组件白屏，怎么放行才不把安全策略掏空？
2025/8/6 上午10:44
alwayly
支付白屏时从浏览器 CSP 报错提取 directive 与域名，通过模块白名单精确放行，并同时检查 script、frame、connect 等资源类型。
继续阅读
