Plausible Analytics 数据迁移后历史数据不可见的解决方案

在自托管环境中将 Plausible Analytics 从旧版本升级到 v2.0.0 时，部分用户可能会遇到历史数据在某些视图中不可见的问题。本文将深入分析这一问题的成因，并提供详细的解决方案。

问题现象

升级完成后，用户可能会发现：

• "最近12个月"视图可以正常显示历史数据
• "全部时间"视图仅显示从升级当天开始的数据
• "自定义范围"视图无法选择升级前的日期

根本原因

这一问题源于 Plausible v2.0.0 的数据迁移机制与新统计系统的交互方式。在升级过程中，系统会重新计算并设置两个关键日期字段：

1. native_stats_start_at：记录站点首次接收数据的原始时间
2. stats_start_date：用于确定统计数据的起始日期

当用户在完成数据迁移前访问了Plausible仪表板，系统会错误地将stats_start_date设置为访问当天的日期，而非正确的历史数据起始日期。

解决方案

步骤一：验证数据库状态

首先需要确认PostgreSQL数据库中站点的相关日期设置：

1. 连接到PostgreSQL数据库
2. 执行查询获取站点信息：

SELECT id, domain, stats_start_date, native_stats_start_at 
FROM sites 
WHERE domain = '你的域名';

步骤二：检查ClickHouse数据范围

确认ClickHouse中实际存储的数据时间范围：

1. 连接到ClickHouse数据库
2. 执行查询获取数据时间跨度：

SELECT min(timestamp), max(timestamp) 
FROM events_v2 
WHERE site_id = [你的站点ID];

步骤三：修正统计起始日期

如果发现stats_start_date不正确，执行以下修正：

UPDATE sites 
SET stats_start_date = '正确的起始日期' 
WHERE id = [你的站点ID];

其中"正确的起始日期"应设置为与native_stats_start_at相同的日期，或者ClickHouse中min(timestamp)对应的日期。

预防措施

为避免此类问题，建议在升级过程中：

1. 首先完成所有数据迁移步骤
2. 在确认迁移完成后才访问Web界面
3. 定期备份数据库，特别是升级前

技术背景

Plausible Analytics v2.0.0 引入了重大的数据架构变更，将原本基于字符串的标识符改为数值型ID。这一改进提升了查询性能，但也带来了复杂的数据迁移过程。系统需要重新建立所有历史数据与新架构之间的关联，包括正确维护各种时间戳和统计范围。

理解这一机制有助于管理员更好地规划升级流程，确保统计数据的完整性和连续性。对于大型站点，建议在非高峰期进行升级，并预留足够的维护时间窗口。