Magento 2.4.1多站点前端mage-messages cookie消息不显示问题求助

1. 校验cookie配置的实际生效值 #

• 首先清空全量缓存确认后台配置已生效，执行命令：bin/magento cache:clean && bin/magento cache:flush
• 打开浏览器控制台「应用」标签页，核对当前站点下mage-messages的domain、path属性，必须和当前站点的域名、根路径完全匹配。多站点如果是二级域名部署，不要将父域名配置为cookie domain，会导致不同子站点的cookie互相覆盖
• 检查CDN/反向代理/WAF是否开启了cookie改写规则，部分安全/加速服务会自动调整cookie作用域，导致Magento前端无法读取到对应cookie

2. 排查前端消息渲染逻辑 #

• 临时切换到Magento默认Luma主题验证问题是否消失，确认自定义主题的messages.phtml模板没有改写错误，默认模板路径为vendor/magento/module-theme/view/frontend/templates/messages.phtml
• 检查浏览器控制台是否存在JS报错，部分自定义插件的JS错误会阻断Magento_Customer/js/customer-data初始化，导致消息无法从cookie拉取渲染
• 手动在控制台执行customerData.get('messages')()查看是否能读到cookie内的消息内容，如果返回空值，说明前端读取cookie的权限被限制，常见于跨站点场景下SameSite属性配置错误

3. 修正SameSite cookie属性配置 #

• Magento 2.3.7+版本默认支持SameSite配置，前往后台「Stores > Configuration > General > Web > Default Cookie Settings」，将SameSite属性设置为Lax，不要设置为Strict，否则跨站点跳转（比如支付回调返回站点）时会丢失cookie
• 低于2.3.7的版本，可以通过自定义插件修改\Magento\Framework\Stdlib\Cookie\CookieMetadata的getSameSite方法，强制返回Lax

4. 排查多站点cookie隔离配置 #

• 如果是同域名下按路径区分的多站点，必须给每个站点单独配置cookie路径，路径值为对应站点的根路径，比如站点A是/cn/、站点B是/en/，不要统一设置为/，会导致不同站点的消息互相覆盖、读取不到
• 检查app/etc/env.php内是否存在硬编码的cookie配置，硬编码配置优先级高于后台配置，会覆盖你在后台设置的内容

5. 临时兜底修复方案 #

如果以上排查都未定位到问题，可以部署自定义JS强制读取mage-messages内容渲染：

require(['jquery', 'Magento_Theme/js/view/messages'], function($, messagesComponent) {
    const getCookie = (name) => {
        const value = `; ${document.cookie}`;
        const parts = value.split(`; ${name}=`);
        if (parts.length === 2) return parts.pop().split(';').shift();
    }
    const messageCookie = getCookie('mage-messages');
    if (messageCookie) {
        const messages = JSON.parse(decodeURIComponent(messageCookie));
        messagesComponent().addMessages(messages);
        // 渲染后清除cookie避免残留
        document.cookie = 'mage-messages=; Path=/; Expires=Thu, 01 Jan 1970 00:00:01 GMT;';
    }
})

将上述代码添加到站点全局通用JS文件即可生效。

内容的提问来源于stack exchange，提问作者Milos Stambolija