如何彻底删除Drupal 9中的文件？解决同名上传加后缀问题

方法一：数据库直接清理（快速解决单文件问题） #

• 操作前必须备份数据库，防止数据丢失。
• 登录数据库管理工具（如phpMyAdmin），找到file_managed表，执行SQL删除目标文件记录：

  -- 按文件名删除，替换成你的PDF文件名
  DELETE FROM file_managed WHERE filename = 'target.pdf';
  -- 或者按文件ID（fid）删除，更精准
  DELETE FROM file_managed WHERE fid = 123;
  

• 同步清理file_usage表中的关联记录（如果存在）：

  DELETE FROM file_usage WHERE fid = 123;
  

• 最后清空Drupal缓存：用Drush执行drush cr，或后台「配置」→「性能」里手动清空。

方法二：自定义Drush命令（适合频繁/批量操作） #

如果每月都要更新文件，写个简单的Drush命令更高效：

<?php
/**
 * @file
 * 自定义Drush命令：按文件名删除Drupal文件记录
 */

use Drupal\file\Entity\File;

/**
 * 注册Drush命令
 */
function custom_file_cleanup_drush_command() {
  $commands['remove-file-record'] = [
    'description' => '删除指定文件名的Drupal文件库记录',
    'arguments' => [
      'filename' => '要删除的文件名（比如document.pdf）',
    ],
    'examples' => [
      'drush remove-file-record "monthly-report.pdf"' => '删除monthly-report.pdf的文件记录',
    ],
  ];
  return $commands;
}

/**
 * 命令回调函数
 */
function drush_custom_file_cleanup_remove_file_record($filename) {
  $files = File::loadByProperties(['filename' => $filename]);
  foreach ($files as $file) {
    // 清理文件使用关联
    \Drupal::service('file.usage')->delete($file);
    // 删除文件实体
    $file->delete();
    drush_print("已删除文件记录：{$filename}（FID: {$file->id()}）");
  }
  // 清空缓存
  drush_cache_clear_all();
}

• 把代码存到自定义模块的custom_file_cleanup.drush.inc文件里，启用模块后，直接用drush remove-file-record "你的文件.pdf"就能彻底删除记录，不会残留。

方法三：修改文件上传设置（无需删除记录，直接覆盖） #

如果只是想上传同名文件不自动加后缀，更省心的方式是改字段配置：

• 进入对应内容类型的「管理字段」，找到文件字段的「编辑」→「字段设置」。
• 找到「文件替换」选项，选择替换现有文件，保存设置。
• 这样上传同名PDF时，会直接覆盖原有文件实体，S3上的文件也会被替换（需确保S3桶权限允许覆盖），原有外部URL完全保留，完美适配每月更新的场景。

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