本文详解在 woocommerce_email_before_order_table 等邮件钩子中正确获取 WooCommerce 订单 ID 的方法，解决因参数传递不一致导致的 $order->get_id() 失效或 PHP 致命错误问题，并提供健壮的兼容性写法与调试建议。
本文详解在 `woocommerce_email_before_order_table` 等邮件钩子中正确获取 woocommerce 订单 id 的方法，解决因参数传递不一致导致的 `$order->get_id()` 失效或 php 致命错误问题，并提供健壮的兼容性写法与调试建议。
在 WooCommerce 邮件系统中，不同版本（尤其是 3.0+）对 woocommerce_email_before_order_table 等钩子的参数传递方式存在细微但关键的差异：该钩子实际接收的第一个参数并非始终是 WC_Order 对象实例，而可能是订单 ID（整型）或已实例化的对象，具体取决于调用上下文和 WooCommerce 版本。这正是你遇到“硬编码 ID 可用，但 $order->get_id() 报错或返回空”的根本原因——代码假设了 $order 恒为对象，但实际可能为 int 或未完全初始化的对象。
正确的做法是统一通过 wc_get_order() 进行标准化实例化，确保无论传入的是 ID、对象还是其他兼容类型，都能获得一个可安全调用方法的 WC_Order 实例：
add_action( 'woocommerce_email_before_order_table', function ( $order, $sent_to_admin, $plain_text, $email ) {
// ✅ 安全获取 WC_Order 实例（兼容 ID 或对象输入）
$order = wc_get_order( $order );
// ❌ 错误示例：直接假设 $order 是对象并调用方法（可能报错）
// echo FS4E_VSDC::fs4e_get_order_slip( $order->get_id() );
// ✅ 推荐：先校验实例有效性，再获取 ID
if ( ! $order || ! is_a( $order, 'WC_Order' ) ) {
error_log( '[WooCommerce Email Hook] Invalid order object received.' );
return;
}
$order_id = $order->get_id();
$slip_html = FS4E_VSDC::fs4e_get_order_slip( $order_id );
// 输出前建议检查返回值，避免空内容破坏邮件结构
if ( ! empty( $slip_html ) ) {
echo wp_kses_post( $slip_html ); // 使用 wp_kses_post 防止 XSS（尤其当 slip 含 HTML 时）
}
}, 10, 4 );⚠️ 关键注意事项：
- 不要直接访问 $order['order_id']：WC_Order 是对象而非数组，$order[order_id] 会触发 Fatal Error: Cannot use object of type WC_Order as array（如你所见）。
- 避免使用 $order->id（已废弃）：WooCommerce 3.0+ 已弃用直接访问 ->id 属性，必须使用 ->get_id() 方法。
- 钩子参数数量必须匹配：woocommerce_email_before_order_table 明确接收 4 个参数（$order, $sent_to_admin, $plain_text, $email），因此 add_action() 的第 4 个参数（$accepted_args）必须为 4，否则 $sent_to_admin 等后续参数将无法正确传入。
- 启用日志调试：在生产环境前，建议临时添加 error_log( print_r( gettype($order) . ' | ' . ( is_object($order) ? $order->get_id() : $order ), true ) ); 快速确认传入类型。
此外，若你的 fs4e_get_order_slip() 方法依赖订单状态或支付信息，请确保在邮件触发时这些数据已持久化（例如：customer_processing_order 邮件中订单状态为 wc-processing，但 customer_completed_order 中才为 wc-completed）。必要时可在钩子内补充状态判断：
if ( 'wc-completed' === $order->get_status() ) {
echo wp_kses_post( FS4E_VSDC::fs4e_get_order_slip( $order_id ) );
}综上，以 wc_get_order() 为中心进行类型安全转换，配合显式对象校验与参数完整性保障，是稳定获取订单 ID 并集成第三方服务（如电子发票、物流单）到 WooCommerce 邮件中的最佳实践。
