Contact Form 7(CF7)邮件模板配置数据存储位置及迁移丢失问题咨询

存储逻辑确认 #

• CF7的「邮件(Mail)」标签页的所有配置，均以PHP序列化格式附加在wpcf7_contact_form类型文章的post_content字段末尾，和表单结构存储在同一个数据库字段中，不会单独存储在其他表或代码文件中。

迁移后配置不显示的根因 #

你遇到的迁移后表单结构正常、仅邮件配置为空的问题，核心原因是数据库迁移时序列化数据被破坏：
PHP序列化格式会标记每个字符串的长度，如果你迁移数据库时做了域名/路径的全局字符串替换，用了普通的文本替换工具（比如直接执行SQL的REPLACE命令），只会修改字符串内容，不会同步更新序列化标记的长度，CF7读取时检测到数据格式不匹配，就会判定配置无效，直接显示为空。

修复与规避方案 #

1. 数据库迁移时使用支持序列化数据修正的工具替换域名，最常用的是WordPress官方WP-CLI工具的搜索替换命令，会自动修正序列化数据的长度标记：

   wp search-replace '你的旧域名（如http://local.dev）' '你的新域名（如https://example.com）' --all-tables
   

2. 已经完成迁移出现配置丢失的情况，可以直接从源站点导出对应CF7表单的JSON配置，到目标站点导入即可，无需手动重填所有配置。
3. 频繁部署的场景可以使用CF7配置同步类插件，将表单配置以文件形式存储在代码目录中，跟随Git仓库同步部署，完全避免数据库迁移导致的配置丢失问题。

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