本文详解如何在gutenberg编辑器中安全使用get_the_id()配合woocommerce订单短代码，避免json解析失败与“call to a member function get_data on bool”等常见错误。核心在于确保订单对象有效、id上下文准确，并规避gutenberg渲染阶段的执行环境陷阱。
本文详解如何在gutenberg编辑器中安全使用get_the_id()配合woocommerce订单短代码，避免json解析失败与“call to a member function get_data on bool”等常见错误。核心在于确保订单对象有效、id上下文准确，并规避gutenberg渲染阶段的执行环境陷阱。
在WordPress + WooCommerce开发中，将动态订单信息嵌入内容模板（如自定义文章类型页面）时，直接在短代码函数内调用get_the_ID()极易引发Gutenberg编辑器崩溃——表现为“Updating failed. The response is not a valid JSON response”，同时PHP报错：Call to a member function get_data() on bool。该错误本质并非ID未获取，而是wc_get_order($id)返回false，导致后续->get_data()调用失败。
根本原因在于：Gutenberg在REST API上下文中预渲染区块时，get_the_ID()可能返回0或无效值（如后台编辑页无主循环上下文），而wc_get_order()对无效ID仅返回false，不抛异常。因此，必须显式校验订单对象有效性，并分离ID获取逻辑。
✅ 正确做法是：不在短代码内部盲目依赖get_the_ID()作为默认值，而应由调用方明确传入有效订单ID。以下是优化后的健壮实现：
function get_order_info( $atts ) {
// 1. 安全提取并验证ID参数
$id = isset( $atts['id'] ) ? absint( $atts['id'] ) : 0;
// 2. 强制要求ID存在（避免在Gutenberg中静默失败）
if ( ! $id ) {
return '<!-- Error: Missing or invalid order ID -->';
}
// 3. 获取订单对象，并严格校验
$order = wc_get_order( $id );
if ( ! $order ) {
return '<!-- Error: Invalid WooCommerce order ID #' . esc_html( $id ) . ' -->';
}
// 4. 提取属性，默认为'id'
$attribute = isset( $atts['attribute'] ) ? sanitize_key( $atts['attribute'] ) : 'id';
// 5. 获取订单数据并返回指定字段（支持常用键：id, status, total, date_created等）
$order_data = $order->get_data();
if ( ! isset( $order_data[ $attribute ] ) ) {
return '<!-- Warning: Order field "' . esc_html( $attribute ) . '" not found -->';
}
return is_scalar( $order_data[ $attribute ] )
? esc_html( $order_data[ $attribute ] )
: wp_json_encode( $order_data[ $attribute ] );
}
add_shortcode( 'order_info', 'get_order_info' );
? 关键改进点说明：
- ID验证前置：使用absint()强制转整型，杜绝字符串ID导致wc_get_order()静默失败；
- 订单对象判空：在调用->get_data()前检查$order是否为WC_Order实例；
- 属性键过滤：用sanitize_key()防止非法数组键访问；
- 安全输出：对非标量值（如日期对象）采用wp_json_encode()，避免HTML注入或JSON序列化中断；
- 清晰错误提示：返回带注释的HTML片段，便于前端调试，而非抛出PHP致命错误。
? 在Gutenberg中安全调用建议：
若模板需复用，推荐在主题或插件中通过PHP模板文件（如single-order-template.php）动态生成短代码字符串，而非在Gutenberg编辑器内硬编码：
// 在模板文件中（非短代码内部！）
if ( have_posts() ) : while ( have_posts() ) : the_post();
$order_id = get_the_ID(); // 此时上下文可靠
echo do_shortcode( "[order_info id='{$order_id}' attribute='total']" );
endwhile; endif;
⚠️ 重要注意事项：
- Gutenberg的区块预览和保存均通过REST API执行，此时get_the_ID()不可靠，绝不可作为短代码默认ID来源；
- 避免在add_shortcode回调中执行耗时操作（如多次wc_get_order()），可考虑缓存订单数据；
- 若需支持前端AJAX加载，务必为order_info短代码添加nonce验证及权限控制（current_user_can('read_shop_order', $id)）。
通过以上重构，短代码可在Gutenberg编辑器、前台页面及REST API场景下稳定运行，彻底规避JSON响应失效与PHP致命错误。
