封面缺失或显示不全：DLSite 没图、下载失败、缓存损坏怎么办

现象分级

情况一：个别作品没封面

大部分作品封面正常，只有零星几个显示占位图或空白。

最可能原因：DLSite 上这几个作品本身就没上传封面——不是你的问题。

解决：手动找图补（如果想追求完美），或接受默认占位图。

情况二：很多作品没封面

几十个甚至上百个作品一起没封面。

可能原因：

1. DLSite 反爬导致封面下载阶段大量失败（元数据抓取也可能一起失败）
2. 扫描器在某个阶段异常退出，封面没来得及下载
3. covers/ 目录权限问题（容器没写权限）

排查：

# Docker：进容器看 covers 目录有多少文件
docker exec -it kikoeru ls /usr/src/kikoeru/covers | wc -l

# 对比数据库里的作品数量，如果差距大，说明下载确实没完成

解决：

1. 确认容器有 covers/ 写权限
2. 重跑一次完整扫描（扫描器有"封面缺失就重新下载"的逻辑）
3. 如果还是不行，手动删掉 covers/ 里的所有文件 → 再扫描一次（强制重新下载）

情况三：所有封面都显示破碎

封面文件其实存在但显示不出来——可能是下载到了半截（文件损坏）。

解决：

# 直接清空 covers 缓存
rm -rf /path/to/covers/*

# 或 Docker 方式
docker exec -it kikoeru rm -rf /usr/src/kikoeru/covers/*

# 然后重跑扫描，强制重新下载所有封面

刷新单个作品的封面

有的版本在作品详情页有"刷新元数据"按钮——点它会重新去 DLSite 抓该作品的所有信息（包括封面）。

适合你只想修复个别作品的情况，不用跑全库扫描。

Docker 权限问题

如果 covers/ 目录是手动创建的，可能权限不对：

# Linux 上修一下权限
sudo chmod -R 777 covers/
# 或更保守的
sudo chown -R $(whoami) covers/

封面文件大小

正常封面图片应该在 20KB ~ 200KB 之间。如果 covers/ 目录里出现 0KB 或很小的文件，就是下载了半截——清掉重下。

总结