更新一篇文章,全站 lastmod 都变成今天:一个 save() 引发的静默事故

2026 年 11 月 18 日,我核对一篇刚发布文章的 JSON-LD,看到 datePublished 是早上 8 点,dateModified 却是下午 3 点 24 分——那正好是我刷新页面的时间。我再扫了一遍 sitemap,发现问题比一篇大:几乎每条 URL 的 lastmod 都指向当天。

第一反应是爬虫在反复抓取。这个解释很顺,因为搜索引擎确实会重复访问页面,而这个站也有主动推送。可顺着这条线查了半天,抓取日志对不上——lastmod 变化的时刻,和我的访问时刻几乎重合,跟爬虫无关。真正的线索在代码里:文章页每被访问一次,浏览量字段就加一,而加一用的是模型的 save()。

这次我先用本机把 ORM 的行为跑出来再下结论。脚本、基准时间、前后对比全部贴在文中,你可以照着重跑一遍。

一、把现象复现出来

我建了一张和文章表同结构的临时表,只保留四个相关字段:views、create_time、update_time。插入一行,把 update_time 写死成一个过去的时间戳 1700000000(对应 2023-11-15 06:13:20),当作「这篇文章真正的最后修改时间」。然后分别用两种写法给 views 加一,看 update_time 会不会动。

// 真实模型子类,和项目里的 Article 模型设置一致
class ProbeModel extends Model
{
    protected $table = 'tmp_ut_probe';
    protected $autoWriteTimestamp = 'int';   // 关键点
}

$base = 1700000000;  // 2023-11-15 06:13:20,假装是真实修改时间

// 写法 A:读出模型 → 改一个字段 → save()
$m = ProbeModel::find(1);
$m->views = $m->views + 1;
$m->save();

// 写法 B:查询构造器直接加一
Db::name('tmp_ut_probe')->where('id', 1)->inc('views', 1)->update();

实跑输出如下。基准时间和当前时间都打出来,方便对照:

基准时间 = 1700000000 (2023-11-15 06:13:20)
当前时间 = 1795067429 (2026-11-19 13:50:29)

=== 初始 ===
insert                         views=10  update_time=1700000000 (2023-11-15 06:13:20)

=== 写法 A:真实 $m->views+=1; $m->save() ===
after Model::save()            views=11  update_time=1795067429 (2026-11-19 13:50:29)
结论:save() 把 update_time 从基准时间刷成了当前时间

=== 复位后 ===
reset                          views=10  update_time=1700000000 (2023-11-15 06:13:20)

=== 写法 B:Db::name()->inc('views',1)->update() ===
after inc()                    views=11  update_time=1700000000 (2023-11-15 06:13:20)
真实 inc() 生成的 UPDATE:
  UPDATE `tmp_ut_probe`  SET `views` = `views` + 1  WHERE  `id` = 1

两种写法都把 views 从 10 加到 11,但对 update_time 做了完全相反的事:save() 把它从 2023 年直接刷成 2026 年当下,inc() 一个字节都没碰。而 inc() 生成的 SQL 只有 SET views = views + 1,根本没有 update_time 这一项——这就是差别所在。

二、为什么 save() 一定要动 update_time

这不是 bug,是设计。ThinkPHP6 的模型默认开启 autoWriteTimestamp(配置在 config/database.php 里,值为 true),模型上还有个 $autoWriteTimestamp = 'int'。合起来的意思是:只要通过模型写库,框架就自动帮你把时间戳字段更新成当前时间。你不需要、也不该手动去写 update_time。

这套机制对绝大多数业务是对的。用户改了昵称、订单状态从待付款变成已付款——这些确实是一次「修改」,把 update_time 刷成当下合情合理。问题出在我把它用在了不属于修改的场景上:浏览量和点击量。

读一篇文章,不是「修改这篇文章」。它产生的是一条访问记录,不是内容变更。但当你写出 $article->views += 1; $article->save(); 时,ORM 并不知道这只是个计数器——它看到的是一次模型保存,于是忠实地帮你刷新 update_time。每来一个访客,全站就「更新」一次。

ThinkPHP 官方手册在 模型章节的「时间戳」小节里写明了 autoWriteTimestamp 的作用和可关闭的方式。手册没写错,是我把一个「为业务修改设计的功能」用在了统计计数上。

三、失真是怎么一路传到 sitemap 和结构化数据的

一个字段被悄悄改写,本身似乎无关痛痒——浏览数是对的,文章也能打开。但它沿着依赖链往下传,最后影响的是搜索引擎判断「这个页面多久没更新了」的依据。

  • sitemap 的 lastmod。 如果 lastmod 取自 update_time,那么每次访问都会让全站所有被访问过的文章在 sitemap 里「今天更新」。搜索引擎看到的是一个永远在更新的站点,但每次抓下来内容都没变。lastmod 的可信度就此归零——它本该是一个「告诉爬虫哪些页面值得重抓」的信号,现在变成噪声。
  • JSON-LD 的 dateModified。 文章页头部那段结构化数据如果也读 update_time,就出现了我一开始看到的现象:datePublished 是早上 8 点,dateModified 却是下午 3 点 24 分——一篇刚发的文章,发布后 7 小时「被修改」,而修改的原因是有人读过它。
  • 内容排序与「最近更新」。 如果首页或侧栏按 update_time 倒序取「最新文章」,那么被访问最多的老文章会一直霸占这个位置,真正的新文反而被挤下去。

Google 在 sitemap 官方文档里对 lastmod 的表述很克制:它是可选的,而且「如果你提供的值不准确,Google 可能会忽略它」。换句话说,一个被访问刷新的 lastmod 不只是没用,还可能让搜索引擎对整份 sitemap 的其他信号也打个问号。这也是我为什么没有在文章里写「我的索引因此掉了」——因为单看这一个字段,没法证明因果,能证明的只是这个字段不再可信。

四、三种修法,我选了第二种

知道根因之后,修法有三种,代价和适用范围不一样。

第一种:关掉模型的时间戳自动写入。 在模型里加 protected $autoWriteTimestamp = false;。能解决问题,但过于粗暴——这个站真正修改文章时确实需要 update_time 自动更新,关掉之后所有更新都得手动维护这个字段,负担更重,也更容易漏。放弃。

第二种:统计计数走查询构造器,不走模型 save()。 这是我现在用的写法。核心就一行区别:

// 错:模型 save(),会连带刷新 update_time
$article->views += 1;
$article->save();

// 对:查询构造器只加计数字段,不碰 update_time
$article->views += 1;                      // 仅用于本次页面展示
Db::name('articles')->where('id', $article->id)->inc('views', 1)->update();

这里的 $article->views += 1 保留下来是有意的:它让本次请求渲染出来的浏览数立刻 +1,不用再查一次库;而真正落库的那一步交给 inc()。两步各司其职,既不影响页面展示,也不污染 update_time。实测里 inc() 生成的 SQL 是 UPDATE ... SET views = views + 1 WHERE id = 1,干净利落。

第三种:把浏览量拆到独立的统计表。 这是更彻底的做法——文章内容表和访问明细表分开,浏览量从明细表聚合。扩展性最好,但要建表、改埋点、改查询,对一个小站来说改动面太大。如果哪天要做「按天/来源的阅读趋势」,我会走这条,眼下没必要。

类似的思路我 earlier 在《ThinkPHP6 后台统计与权限实战:从表设计到图表》里也用过:先想清楚这个字段到底是「内容属性」还是「统计数据」,再决定它该待在哪张表、由哪层代码写。

五、web 框架里这是个通用问题,不是 TP6 独有

只要 ORM 提供「自动维护 updated_at」的能力,这个坑就存在。Laravel 的 Eloquent 默认维护 updated_at,用 $model->increment('views') 就不会触发它更新——和 TP6 的 inc() 是同一个道理。Django 的 auto_now 字段也只在 save() 时更新,用 QuerySet.update() 可以绕开。Rails 的 touch 同理。

名字不同,规则一致:通过模型实例保存,自动时间戳生效;通过批量更新语句改字段,自动时间戳不生效。 所以每次写出「读出来 → 改一个计数字段 → 存回去」这三连的时候,都值得停一下,问一句:这次操作到底算不算「修改」?

顺带一提,PHP 手册在 time() 的说明里提醒过服务器时区对时间戳的影响。排查这类问题时,我会把基准时间、当前时间、落库时间三个值都打出来(就像上面那段输出),避免把「时区差了 8 小时」误判成「时间戳被刷新」——这两个现象在系统里看起来很像。

六、这套结论的边界

  • 本机是 PHP 7.3 + TP6 + 本地 MySQL,行为不代表所有版本。 不同 TP6 小版本对 autoWriteTimestamp 的默认处理有差异,上线前请在你自己的版本上重跑脚本。
  • 临时表实验隔离于业务数据。 脚本建 tmp_ut_probe 表,跑完 drop,不碰真实文章表。你重跑时也建议这么做。
  • 只覆盖了 int 类型时间戳。 如果字段是 datetime 或 timestamp 类型,SQL 写法和显示格式会变,但「save() 会更新、inc() 不更新」的方向不变。
  • 没测并发。 articles.views = views + 1 是数据库层面的原子加一,多访客同时访问不会丢计数;但如果你在应用层先读后写,就会有竞态。这不是本文重点,单独说明避免误解。
  • 修好字段不等于修复了 credibility。 如果 sitemap 的 lastmod 已经错了一段时间,修正代码之后需要重新生成一次 sitemap,让搜索引擎拿到新的、可信的时间值。代码改了但 sitemap 没重建,问题照样存在。

回头看这次排查,最坑的地方不是技术本身,而是它太安静了:没有报错、没有异常日志、浏览数还是对的、页面照常打开。唯一的线索是 dateModified 比 datePublished 晚了七个小时。如果我不去看那段结构化数据,这个静默覆盖可以一直藏着。方法上和我在《429 限流下重试到底省了什么》里做的一样:遇到「看着没问题但数据不对」的情况,先把字段的前后值用实验跑出来,别靠推理下结论。

如果你也在用带自动时间戳的 ORM,建议现在就去翻一下自己代码里所有「浏览量 +1」「点击数 +1」「下载数 +1」的地方。发现是模型 save() 的,换成查询构造器的 inc(),五分钟就能修完。至于 sitemap 和 JSON-LD 该怎么设计时间字段,我在《ThinkPHP6 上线部署:宝塔 + Nginx 伪静态 + 定时任务的完整踩坑》里也聊过部署侧的注意点,可以对照着看。

相关推荐

评论(0)
发表评论
▾
安卓、IOS免费上传工具
推荐
安卓、IOS免费上传工具
拖拽上传 IPA 文件,自动解析 Bundle ID、版本号、签名信息、备案公钥等
了解详情 ›
广告