WordPress中add_post_meta()函数传入变量值失效的问题求助

碰到这种“硬编码字面量能生效，传变量就失效”的场景，基本都是变量实际值、运行时序、作用域这几类问题，逐一核对即可：

• 最常见的原因：变量实际值和预期不符
  很多人默认写了$name = "Bob"，传进去就一定是"Bob"，但实际开发中很容易出现值被篡改、作用域丢失的情况：
  • 检查作用域：如果add_post_meta是写在自定义函数、类方法内部，一定要确认$name是当前作用域内可访问的变量。如果$name是在全局代码中定义的，函数内部没有通过global $name引入，实际拿到的$name值是NULL，自然无法正常写入。
  • 检查值的完整性：尤其是从用户输入、接口返回、全局超全局变量里取的$name，要在传参前打印实际值，排查是否存在空字符串、前后带不可见的空格/换行、被转义成数组/对象的情况——WordPress的add_post_meta对空值的写入是静默跳过的，和你硬编码"Bob"的行为差异极大。
• 容易踩的坑：跨请求的变量失效
  如果你的$name是在页面渲染阶段（比如前台模板、文章编辑页加载时）定义的，后续点“保存文章”触发的是全新的POST请求，上一次请求存在内存里的$name变量根本不会带到新请求里，这时候传进去的$name本质是NULL。而你硬编码的字面量是直接写在保存逻辑的代码文件里的，每次请求都能正常读取，所以永远能生效。
• 容易误判的场景：唯一性参数导致的静默跳过
  你调用时最后一个参数传了true，代表这个meta key对当前文章是唯一的。如果之前已经给当前post_id写入过同key、同值的meta记录，add_post_meta会直接跳过执行，不会重复写入也不会报错。你第一次测字面量"Bob"的时候数据库里没有对应记录，所以能写入；第二次用变量传的时候，数据库里已经有相同的meta值了，看起来就像“代码没生效”，实际去自定义字段列表里查看，对应的值本来就已经存在了。这种情况要么先删除旧的同key meta记录再测试，要么直接换用update_post_meta()强制覆盖写入。
• 隐藏原因：钩子过滤逻辑篡改变量
  WordPress的自定义元数据写入全链路都内置了过滤钩子，部分插件、自定义功能会针对特定meta key添加值过滤规则，如果你传入的变量值触发了过滤条件（比如值长度不足、包含敏感字符），就会被直接清空成空值，导致写入失败。这种时候可以直接用数据库查询对应post的meta记录，排查是不是值被中途清空了。

最快定位问题的方法：在add_post_meta调用的前一行加临时调试代码：
var_dump($post_ID, 'Name', $name, true); die();
触发保存流程后，看页面打印的三个参数实际值，和你预期的参数是否完全一致，就能快速锁定是哪一环出了问题。

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