手动插入数据到directus_files表后如何重新生成缩略图

你不需要关注缩略文件名里的哈希生成规则，用Directus官方提供的内置能力即可完成批量/单文件的缩略图重生成，完全适配官方的命名、存储规则：

方法1：CLI命令生成（推荐，适合批量场景） #

这是最高效的方案，无需额外配置，直接调用官方内置命令即可：

• 终端进入Directus项目根目录
• 全量生成所有缺失的缩略图：

  npx directus files:thumbs generate
  

• 指定单个/多个文件UUID生成：

  npx directus files:thumbs generate <文件1的UUID> <文件2的UUID>
  

• 强制覆盖已存在的缩略图：

  npx directus files:thumbs generate --force
  

执行完成后所有缩略图会完全匹配后台手动上传的生成规则，自动处理文件名哈希、尺寸、存储路径等所有逻辑。

方法2：后台触发更新（适合少量文件场景） #

如果只有少量文件需要处理，不需要使用命令行：

• 登录Directus管理后台，进入「文件库」模块
• 找到对应手动插入的文件，点击编辑无需修改任何字段，直接保存
• Directus会自动校验该文件的缩略图完整性，自动补全缺失的缩略图

故障排查 #

如果执行操作后缩略图仍然无法加载，检查两个配置项：

• 缩略图存储文件夹的读写权限，确认Directus运行时所属用户对该目录有读写权限
• 核对directus_files表中storage字段值，和你实际存储文件所用的适配器名称是否一致

内容的提问来源于stack exchange，提问作者sarah.ferguson