Puock 主题 TimThumb 报 400，或图片被裁剪时怎么处理

用 Puock 这类主题时，文章列表里的随机图或缩略图有时会走 timthumb.php，比如地址里会带上 w=280&h=160&src=... 这类参数。看起来图片路径没问题，直接打开 src 原图也能正常显示，但套到 TimThumb 后就是 400，这种情况先别急着改主题路径。

这类问题的关键判断是：原图能打开，说明主题路径、静态资源路径和外层 URL 大概率是通的；TimThumb 报错，更多时候是它在生成缩略图时没有办法写缓存。

先看报错内容，不要只看 400

这次遇到的现象是，src 指向的随机图可以直接访问，但 TimThumb 地址返回 400。继续看响应内容，里面出现了类似下面两类提示：

Could not create the index.html file
Could not create cache clean timestamp file

这两个提示基本都指向同一个方向：TimThumb 想在缓存目录里写文件，但目录不存在、权限不对，或者 Web 服务用户没有写权限。

为什么原图正常，缩略图还是失败

直接打开原图时，Nginx、OpenResty 或 Apache 只需要把静态文件读出来返回给浏览器。

但 TimThumb 不只是读图。它通常还会做几件事：

1. 读取 src 原图。
2. 按参数裁剪或缩放。
3. 把处理后的结果写入主题缓存目录。
4. 后续同尺寸请求直接复用缓存。

所以原图能读，只能证明读取路径正常；不能证明 PHP 进程对缓存目录有写权限。

优先检查主题缓存目录

Puock 主题的 TimThumb 缓存通常会落在主题目录下的缓存路径，常见位置类似：

wp-content/themes/wordpress-theme-puock/cache/thumbnail

实际路径要以你服务器上的主题目录为准。如果主题目录名刚从旧目录改成了 wordpress-theme-puock，也要确认缓存目录是在新主题目录下，而不是还停留在旧主题目录里。

可以按这个顺序查：

1. 缓存目录是否存在。
2. 缓存目录的属主是否和 PHP / Web 服务运行用户一致。
3. 目录是否允许写入。
4. 目录下是否能创建 index.html 和缓存清理时间戳文件。

可以这样处理

如果确认是缓存目录缺失，可以先创建目录：

mkdir -p wp-content/themes/wordpress-theme-puock/cache/thumbnail

然后根据你的运行环境调整属主。不同面板和系统里的用户可能不一样，常见是 www、nginx、apache、www-data，不要照抄，要先确认自己的 PHP-FPM 或 Web 服务用户。

示例：

chown -R www:www wp-content/themes/wordpress-theme-puock/cache
chmod -R u+rwX,g+rwX wp-content/themes/wordpress-theme-puock/cache

如果是 1Panel、宝塔或 Docker 部署，要特别注意容器里的用户和宿主机看到的用户可能不是一回事。权限改完后，再访问 TimThumb 地址，看它是否能正常生成缩略图。

路径改对了，也可能还要清缓存

如果主题目录曾经回滚或改名，浏览器、主题缓存、页面缓存、CDN 缓存里都可能还留着旧路径。处理目录权限后，可以顺手清理：

• 主题自身缓存。
• WordPress 缓存插件。
• CDN 或 Cloudflare 缓存。
• 浏览器强缓存。

但清缓存应该放在权限确认之后。否则只是把旧错误刷新成新错误，并没有解决 TimThumb 写不进去的问题。

如果不是 400，而是不想被裁剪或二次处理

还有一种情况不是 TimThumb 报错，而是图片已经能显示，但你发现列表图被裁剪、变糊，或者明明上传的是已经压缩过的 WebP，页面里却还走了类似这样的地址：

timthumb.php?w=280&h=160&a=c&zc=1&q=90&src=https://example.com/wp-content/uploads/2026/06/example.webp

这串参数大概可以这样理解：

1. w=280&h=160：生成 280 x 160 的缩略图。
2. a=c：按居中位置处理。
3. zc=1：启用裁剪，优先填满目标尺寸。
4. q=90：质量参数是 90。
5. src=...：真正的原图地址。

所以它不只是“压缩图片”，更准确地说是“按主题需要重新生成一张固定尺寸的缩略图”。如果你自己已经用工具压缩好了 WebP，只是希望主题直接用原图，这时可以不用先改 PHP 代码，先看主题后台有没有现成开关。

Puock 新版可以直接禁用 TimThumb 缩略图

Puock 主题后台有一个更省事的入口：

Puock 主题设置 -> 全局设置 -> 禁用 timthumb 缩略图

开启这个选项后，主题生成缩略图地址时会直接返回原始图片地址，不再拼 timthumb.php?w=...&h=...&src=... 这种链接。

从源码逻辑看，Puock 里生成缩略图的函数大致是这个意思：

function pk_get_img_thumbnail_src($src, $width, $height, $args = array()) {
    if (pk_is_checked('disable_timthumb')) {
        return $src;
    }

    return PUOCK_ABS_URI . "/timthumb.php?w={$width}&h={$height}&a=c&zc=1&q=90&src=" . $src;
}

也就是说，disable_timthumb 这个开关打开后，主题就不再把图片交给 TimThumb 二次裁剪，而是直接把原图地址输出给页面。

什么情况下适合开启这个选项

我觉得下面几种情况比较适合开启：

1. 你上传前已经把图片压缩成 WebP。
2. 你更在意图片不要被二次裁剪、二次处理。
3. 首页、列表页图片数量不算特别夸张。
4. 你的原图尺寸本身已经比较克制，不是动不动几 MB 的大图。

如果站点首页一次展示很多文章卡片，原图又很大，那完全禁用 TimThumb 后，页面可能会多加载一些图片体积。这个时候可以配合图片压缩、CDN、自适应图片或缓存插件一起看效果。

更新主题前先备份

如果你的服务器上不是最新版 Puock，不建议直接在线上硬改。更稳的做法是：

1. 先备份当前主题目录。
2. 备份数据库，至少保证主题设置和文章数据能回退。
3. 更新主题后先检查首页、文章页、分类页样式。
4. 如果页面乱了，先回退主题，再排查是不是缓存、子主题或自定义 CSS 影响。

这次我自己的处理就是先备份主题，再更新 Puock。更新后后台选项正常，页面样式也比旧版本更舒服，就可以直接用主题自带开关解决。

怎么验证是否生效

开启“禁用 timthumb 缩略图”后，可以这样验证：

1. 打开首页或文章列表页。
2. 用浏览器开发者工具查看图片地址。
3. 如果图片地址还包含 timthumb.php，说明没有生效，或者页面缓存还没刷新。
4. 如果图片地址变成 /wp-content/uploads/... 这种原图路径，说明主题已经绕过 TimThumb。

改完后记得清一下页面缓存、CDN 缓存和浏览器缓存。否则你看到的可能还是旧 HTML 里的旧图片地址。

结论

看到 TimThumb 缩略图 400，但 src 原图能打开时，不要先怀疑图片 URL。更稳的排查顺序是：

1. 直接打开 src，确认原图可读。
2. 打开 TimThumb 地址，看响应体里的具体错误。
3. 如果提示无法创建 index.html 或缓存时间戳文件，优先修主题缓存目录权限。
4. 如果只是想避免图片被裁剪或二次处理，先试 Puock 后台的“禁用 timthumb 缩略图”。
5. 权限修完或开关调整后，再清主题、CDN 和浏览器缓存。

这类问题表面上都和图片地址有关，但处理方向不一样：报 400 时重点查缓存目录写权限；图片能显示但不想被裁剪时，优先用主题后台开关禁用 TimThumb。