手机端ACF前端提交CPT：图片仅存媒体库未关联

问题描述 #

使用ACF在前端提交team_member自定义文章类型的代码在桌面端运行正常，但手机端提交时，图片会存入媒体库却无法关联到对应的自定义文章类型，相关代码如下：

前端提交代码 #

$user_info = get_userdata(get_current_user_id());
$args = array(
    'post_id'       => 'new_post',
    'field_groups'  => array(570), // 自定义字段组ID
    'form' => false,
    'new_post'      => array(
        'post_type'     => 'team_member',
        'post_status'   => 'pending',
        'post_title'    => $user_info->user_login
    ),
);
acf_form( $args );

functions.php 中的处理代码 #

function my_pre_save_post( $post_id ) {

// 非新帖子则直接返回
if( $post_id !== 'new_post' ) {
     
    return $post_id;
    
}
    

$my_post = array(
    'post_type' => 'team_member'
);
// 插入帖子
$post_id = wp_insert_post( $my_post );
}

问题原因 #

1. 核心错误：my_pre_save_post函数插入新帖子后未返回生成的post_id，ACF无法获取正确的帖子ID，导致图片等字段无法关联到新创建的帖子；移动端的异步处理特性放大了这个问题，而桌面端可能因缓存或同步逻辑暂时掩盖了错误。
2. 参数缺失：手动构造的$my_post数组缺少前端设置的post_status和post_title参数，导致插入的帖子状态、标题不符合预期。
3. 若未添加acf/pre_save_post钩子，函数根本不会被触发，直接导致ACF无法处理新帖子的字段关联。

修复方案 #

1. 修正my_pre_save_post函数 #

修改后需确保返回新帖子ID，并继承前端设置的参数：

function my_pre_save_post( $post_id ) {
    // 非新帖子则直接返回
    if( $post_id !== 'new_post' ) {
        return $post_id;
    }

    // 获取当前用户信息，继承前端的帖子标题设置
    $user_info = get_userdata(get_current_user_id());
    // 构造完整的帖子参数
    $my_post = array(
        'post_type'     => 'team_member',
        'post_status'   => 'pending',
        'post_title'    => $user_info->user_login,
        'post_author'   => get_current_user_id() // 可选：设置帖子作者为当前提交用户
    );

    // 插入帖子并获取ID
    $post_id = wp_insert_post( $my_post );

    // 必须返回新的post_id，ACF才能将字段关联到该帖子
    return $post_id;
}
// 绑定ACF预保存钩子，确保函数生效
add_filter('acf/pre_save_post' , 'my_pre_save_post');

2. 检查移动端环境 #

• 确认ACF的前端JS在移动端正常加载，未被缓存插件或移动端主题禁用；
• 通过Chrome调试工具查看移动端浏览器控制台，排查是否存在表单提交相关的JS错误。

3. 验证ACF字段设置 #

• 确保图片字段的「返回格式」设置为「图像ID」或「数组」（而非仅返回URL），否则ACF无法完成图片与帖子的关联；
• 确认字段组已正确关联到team_member自定义文章类型。

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