本文详解如何在 woocommerce 中安全、可靠地生成商品复制链接，重点解决因 nonce 生成不匹配导致的“链接已过期”错误，并提供符合 wordpress 安全规范的标准实践。
本文详解如何在 woocommerce 中安全、可靠地生成商品复制链接，重点解决因 nonce 生成不匹配导致的“链接已过期”错误，并提供符合 wordpress 安全规范的标准实践。
在 WooCommerce 后台，点击“Duplicate”按钮可快速克隆商品——这一功能依赖 WordPress 的 nonce（一次性令牌）机制进行权限与时效校验。但若手动拼接复制 URL（如 edit.php?action=duplicate_product&post=ID&_wpnonce=...），极易因 nonce 名称不匹配、作用域错误或 URL 编码问题触发 “The link you followed has expired. Please try again.” 错误。
根本原因在于：WooCommerce 并非使用通用 action nonce（如 'woocommerce_product_duplicate'），而是为每个商品 ID 动态生成唯一绑定的 nonce，其格式为 'woocommerce-duplicate-product_{post_id}'。直接调用 wp_create_nonce('woocommerce_product_duplicate') 生成的令牌与后台校验逻辑不一致，导致验证失败。
✅ 正确做法是使用 WordPress 内置的 wp_nonce_url() 辅助函数，它会自动构造合法 URL 并注入匹配的 nonce：
$post = get_post(47447);
if ($post instanceof WP_Post && $post->post_type === 'product') {
$duplicate_url = wp_nonce_url(
admin_url("edit.php?post_type=product&action=duplicate_product&post={$post->ID}"),
"woocommerce-duplicate-product_{$post->ID}"
);
echo '<a href="'%20.%20esc_url(%24duplicate_url)%20.%20'" class="button" aria-label="'
. esc_attr__('Duplicate this product', 'woocommerce') . '">'
. esc_html__('Duplicate', 'woocommerce') . '</a>';
}
⚠️ 关键注意事项：
- Nonce 名称必须精确匹配：格式为 woocommerce-duplicate-product_{ID}（注意连字符 -，非下划线 _，且 {ID} 为具体数字）；
- URL 必须经 admin_url() 构造：确保路径符合当前站点配置（如子目录、HTTPS 等），避免硬编码域名；
- & 符号需转义为 &（仅在 HTML 属性中）：若嵌入 ，PHP 输出前应使用 esc_url()，而非手动拼接未转义的 &；
- 操作必须在管理员上下文中执行：该链接仅对具备 publish_products 能力的用户有效，前端不可直接暴露；
- 避免缓存 nonce 链接：nonce 具有时效性（默认 24 小时），切勿长期存储或复用旧链接。
? 进阶提示：如需在自定义列表页或批量操作中添加复制按钮，建议复用 WooCommerce 原生逻辑——参考 WC_Admin_Duplicate_Product::get_duplicate_link() 方法，或钩入 manage_product_posts_columns + manage_product_posts_custom_column 实现无缝集成。
遵循上述模式，即可彻底规避 nonce 失效问题，稳定调用 WooCommerce 内置的商品复制功能。
