如何修改WordPress媒体上传路径？规避数据库问题与更新丢失

嘿，这个需求我刚好折腾过好几次，给你分享几个亲测有效的方案，既能满足路径修改的要求，还能避免踩坑，而且WordPress更新后也不会失效：

一、直接改成根目录（/FILE） #

这个是最简单的，不用动数据库（除非要迁移旧文件），代码加了就生效，而且更新不会覆盖。

操作步骤： #

1. 推荐用子主题的functions.php或者自己建一个简单的自定义插件（比直接改主题functions.php更安全，避免主题更新覆盖）
2. 把下面的代码加进去：

// 修改媒体上传路径为网站根目录，取消年月子目录
add_filter('upload_dir', 'custom_upload_root_dir');
function custom_upload_root_dir($dirs) {
    // 替换默认上传目录为网站根目录
    $dirs['path'] = ABSPATH;
    $dirs['url'] = site_url('/');
    // 关闭自动生成的年月子目录
    $dirs['subdir'] = '';
    $dirs['basedir'] = ABSPATH;
    $dirs['baseurl'] = site_url('/');
    $dirs['error'] = false;
    return $dirs;
}

3. 保存后，上传一个测试文件，你会发现它直接存在网站根目录，URL就是你的域名/FILE

二、按文件类型分类（/file_type/FILE） #

如果想按图片、文档、视频分开存储，比如/images/xxx.jpg、/docs/xxx.pdf，可以用下面的代码：

// 按文件类型设置媒体上传路径
add_filter('upload_dir', 'custom_upload_dir_by_file_type');
function custom_upload_dir_by_file_type($dirs) {
    global $current_upload_file_type;
    if (!$current_upload_file_type) {
        return $dirs;
    }

    // 根据MIME类型分配子目录
    $type_subdir = '';
    if (strpos($current_upload_file_type, 'image') !== false) {
        $type_subdir = '/images';
    } elseif (strpos($current_upload_file_type, 'application') !== false) {
        $type_subdir = '/docs';
    } elseif (strpos($current_upload_file_type, 'video') !== false) {
        $type_subdir = '/videos';
    } elseif (strpos($current_upload_file_type, 'audio') !== false) {
        $type_subdir = '/audios';
    }

    // 更新路径和URL
    $dirs['path'] = ABSPATH . $type_subdir;
    $dirs['url'] = site_url($type_subdir);
    $dirs['subdir'] = '';
    $dirs['basedir'] = ABSPATH . $type_subdir;
    $dirs['baseurl'] = site_url($type_subdir);
    $dirs['error'] = false;

    // 自动创建目录（如果不存在）
    if (!file_exists($dirs['path'])) {
        mkdir($dirs['path'], 0755, true);
    }

    return $dirs;
}

// 捕获当前上传文件的MIME类型
add_filter('wp_handle_upload_prefilter', 'capture_upload_file_type');
function capture_upload_file_type($file) {
    global $current_upload_file_type;
    $current_upload_file_type = $file['type'];
    return $file;
}

这段代码会自动识别文件类型，创建对应的目录，上传后文件就会出现在对应的分类目录里。

关键注意事项（避坑指南） #

• 为什么用代码而不是改设置？：WordPress后台的媒体设置里虽然可以改路径，但默认会保留年月目录，而且如果用了某些缓存或安全插件，可能会失效；更重要的是，代码方法不会被WordCore更新覆盖，稳定性更高。
• 旧文件迁移怎么办？：如果之前已经上传了很多文件，需要：
  1. 手动把旧文件从wp-content/uploads/移动到新路径（比如根目录或对应分类目录）
  2. 备份数据库后，用SQL语句替换旧的URL路径（替换成你的域名）：

     UPDATE wp_posts SET guid = REPLACE(guid, 'http://yourdomain.com/wp-content/uploads/', 'http://yourdomain.com/');
     UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'http://yourdomain.com/wp-content/uploads/', 'http://yourdomain.com/');
     

• 权限问题：确保新目录的权限是755，文件权限是644，这样WordPress能正常读写文件。
• 测试验证：修改后一定要上传测试文件，检查媒体库、前端显示是否正常，避免出现404错误。

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