问题描述
在 magento 2.4.3 版本中，部分用户发现其订单确认邮件（或其他销售相关邮件）无法正常显示订单中的商品详情。尽管邮件模板中已经包含了用于渲染商品列表的正确布局句柄，例如：
{{layout handle="sales_email_order_items" order_id=$order_id area="frontend"}}但最终发送的邮件中，商品区域仍然是空白的。此问题不受自定义主题影响，即使切换回 Magento 默认的 Luma 主题，问题依然存在。此外，从 Magento 2.4.1 升级到 2.4.3 后，此问题也未能得到解决。
根本原因分析
Magento 在不同版本间对模板渲染机制，特别是邮件模板中的布局句柄处理方式可能进行了调整。在某些特定配置或升级路径下，旧有的渲染逻辑可能未被完全激活或兼容，导致依赖特定标签或渲染模式的商品详情无法正确加载。本问题的解决方案指向激活一个“遗留标签”，暗示了 Magento 内部存在一个兼容性开关，用于调整模板引擎的行为。
解决方案：激活数据库中的遗留标签
解决此问题的关键在于通过直接修改数据库来激活一个特定的“遗留标签”。这将改变 Magento 处理邮件模板的方式，使其能够正确渲染商品详情。
操作步骤：
备份数据库： 在进行任何数据库修改之前，务必对您的 Magento 数据库进行完整备份。这是预防数据丢失或损坏的关键步骤。
-
访问数据库： 您可以通过以下任一方式访问 Magento 数据库：
-
执行 SQL 命令： 找到您的 Magento 数据库，并执行以下 SQL UPDATE 命令：
UPDATE `core_config_data` SET `value` = 1 WHERE `path` = 'dev/email/legacy_template_processing';
命令解释：
- core_config_data: 这是 Magento 存储系统配置的表。
- path = 'dev/email/legacy_template_processing': 这是指向控制邮件模板遗留处理模式的配置路径。
- value = 1: 将此配置的值设置为 1，表示激活遗留模板处理模式。
-
清除 Magento 缓存： 完成数据库修改后，必须清除 Magento 的缓存，以确保系统加载最新的配置更改。在 Magento 根目录下执行以下命令：
php bin/magento cache:clean php bin/magento cache:flush
或者，您也可以通过 Magento 后台的“系统”>“工具”>“缓存管理”来清除缓存。
验证解决方案
在完成上述步骤并清除缓存后，您需要验证解决方案是否生效。
- 下达一个测试订单： 在您的 Magento 商店中下达一个新订单。
- 检查订单确认邮件： 检查收到的订单确认邮件，确认商品详情（包括商品名称、数量、价格等）是否已正确显示在邮件内容中。
如果商品详情现在能够正常显示，则说明遗留标签已成功激活，问题得到解决。
注意事项与最佳实践
- 数据库操作谨慎： 直接修改数据库需要谨慎，请确保您了解所执行的命令及其潜在影响。始终先进行备份。
- 版本兼容性： 此解决方案主要针对 Magento 2.4.3 版本中遇到的特定问题。在其他 Magento 版本中，可能存在不同的解决方案或此方法不适用。
- 未来更新： Magento 官方可能会在未来的版本更新中彻底解决此类兼容性问题，届时此“遗留标签”可能不再需要，或者有新的推荐配置。建议关注 Magento 的发布说明。
- 开发环境先行： 建议在开发或测试环境中先行验证此解决方案，确认无误后再应用于生产环境。
总结
Magento 2.4.3 订单确认邮件不显示商品详情的问题，通常是由于模板渲染机制的兼容性问题所致。通过在数据库中激活 dev/email/legacy_template_processing 配置项，可以强制 Magento 使用一种遗留的模板处理模式，从而恢复商品详情的正常显示。此方法提供了一个直接且有效的解决方案，帮助用户确保其订单确认邮件能够完整、准确地传递所有必要信息。
