ESP32 工程实践：正确处理网络校时、北京时间与离线计时
设备刚启动时，系统时间可能还未校准。如果立即把读数写成带日期的日志，容易出现 1970 年记录。另一类问题是把 Unix 时间手工增加八小时后存储，后来显示时又转换时区，最终多偏移八小时。
正确做法是分别处理绝对时间、显示时区和经过时间。日志与服务器交换 UTC 时间戳，界面显示时转换为北京时间；采样间隔和超时使用单调计时。
示例使用 Arduino-ESP32 3.x，未完成实机验证。网络授时依赖 DNS、UDP 和授时服务器可达性，示例不提供可信时间认证。
使用北京时间显示
POSIX 时区字符串的符号方向与常见 UTC 偏移写法不同：CST-8 表示 UTC+8。这里的 CST 是显示缩写，不能用它独自表达完整的地区规则。中国当前不使用夏令时，此处采用固定 UTC+8。
#include <Arduino.h>
#include <WiFi.h>
#include <time.h>
const char* SSID = "YOUR_SSID";
const char* PASS = "YOUR_PASSWORD";
bool timeServiceStarted = false;
uint32_t lastPrint = 0;
// 仅用于教学中的合理性门槛，并不证明已完成本轮网络校时。
constexpr time_t EARLIEST = 1704067200; // 2024-01-01 00:00:00 UTC
void setup() {
Serial.begin(115200);
WiFi.mode(WIFI_STA);
WiFi.begin(SSID, PASS);
}
void loop() {
if (!timeServiceStarted && WiFi.status() == WL_CONNECTED) {
configTzTime("CST-8", "pool.ntp.org", "time.google.com");
timeServiceStarted = true;
}
const uint32_t tick = millis();
if (uint32_t(tick - lastPrint) >= 2000) {
lastPrint = tick;
time_t now = time(nullptr);
if (now < EARLIEST) {
Serial.println("time unavailable; keep monotonic timestamp");
} else {
struct tm local = {};
localtime_r(&now, &local);
char text[32];
strftime(text, sizeof(text), "%Y-%m-%d %H:%M:%S %z", &local);
Serial.printf("epoch=%lld local=%s\n", (long long)now, text);
}
}
delay(10);
}
配置 SNTP 不代表立即完成同步，示例会持续运行并周期性查看时间。选择网络允许访问的授时服务器，遵守其使用政策；多台设备避免集中高频请求。生产项目还应补充 Wi-Fi 重连流程。
合理日期与新鲜授时不同
now >= EARLIEST 只能过滤明显无效的初始日期。设备可能保留旧时间，也可能接收到错误时间，所以不能把这个判断当作“本轮同步成功”的证明。
需要判断授时新鲜度时，应根据当前 ESP-IDF/Arduino 版本的 SNTP 同步通知接口记录同步事件、最近同步时刻和运行时长。回调中只记录轻量状态，跨任务访问共享变量需正确同步。对于安全审计和签名校验，还需要独立评估时间可信来源。
为什么超时不要使用日历时间
假设某个连接在 12:00:00 开始，等待五秒超时，期间网络校时把系统时间调回一分钟。若用 time() 相减，超时判断就可能被延后。
短周期任务用 uint32_t(millis() - start) 比较经过时间；需要微秒级或较长的运行时计数，可查看 esp_timer_get_time()。这些运行时计数不应跨断电或复位当作永久时间戳使用，深睡恢复也需要重新建立会话。
离线数据怎样保存
未授时时保存启动会话标识、递增序号、运行时计数和 time_valid=false。校时成功后，可为同一连续运行会话中的历史数据估算绝对时间，但要标注估算，并考虑振荡器误差。跨断电且没有电池 RTC 的记录，不能仅凭运行时计数准确恢复日期。
服务器保存 UTC 时间戳，并在展示层转换时区。对日志排序还应使用序号，避免时间被向后修正后出现顺序混乱。
验证清单
分别测试正常联网、启动时离线、阻断授时服务和运行中恢复网络。确认未授时时没有伪装成有效日期的记录；比较 UTC 与本地显示是否相差八小时；手动调整时间后检查任务周期是否保持正常。
浙公网安备 33010602011771号