NTPClient是否更新ESP32板载日期时间？代码问题求助

核心结论 #

NTPClient的update()方法不会自动设置ESP32的系统时钟。它仅将从NTP服务器获取的时间存储在自身内部变量中，因此getFormattedTime()能返回正确时间，但系统原生的gettimeofday()仍会读取初始的1970年epoch时间。

你的代码存在的问题 #

1. 未同步系统时钟：获取到NTP时间后，没有将其写入ESP32的系统时钟模块，导致getDateTime()调用的系统时间始终未更新。
2. 函数参数错误：print()方法定义为无参，但调用时传入了字符串参数，会导致编译报错。
3. 时区未配置：默认使用UTC时间，若需本地时区时间，未做对应的偏移设置。

非阻塞实现方案 #

以下是修复后的完整代码，实现NTP时间获取并同步系统时钟，同时保证非阻塞特性：

文件 Ntp.h

class Ntp
{
private: 
    bool ntpRunning = false;
    
public:
    void setup();
    void loop();
    void print(const String& message);
    String getDateTime();
};

文件 Ntp.cpp

#include <NTPClient.h>
#include <Arduino.h>
#include <WiFi.h>
#include <WiFiUdp.h>

#include <Logger.h>

#include "Ntp.h"

WiFiUDP ntpUDP;
// 配置：NTP服务器、时区偏移（东八区为28800秒）、更新间隔（60秒）
NTPClient timeClient(ntpUDP, "pool.ntp.org", 28800, 60000);


String Ntp::getDateTime()
{
    struct timeval tv;
    time_t nowtime;
    struct tm *nowtm;
    char tmbuf[64];
    char buf[64];

    gettimeofday(&tv, NULL);
    nowtime = tv.tv_sec;
    nowtm = localtime(&nowtime);
    strftime(tmbuf, sizeof tmbuf, "%Y-%m-%d %H:%M:%S", nowtm);
    snprintf(buf, sizeof buf, "%s.%06ld", tmbuf, tv.tv_usec);

    return String(buf);
}

void Ntp::print(const String& message)
{
    Serial.print(getDateTime());
    Serial.print(" - ");
    Serial.println(message);
}

void Ntp::setup()
{
    // 设置本地时区（东八区），让localtime()返回正确本地时间
    setenv("TZ", "CST-8", 1);
    tzset();
}

void Ntp::loop()
{
    if (!this->ntpRunning && WiFi.status() == WL_CONNECTED)
    {
        timeClient.begin();
        this->ntpRunning = true;
        this->print("NTP服务启动");
    }

    if (this->ntpRunning && timeClient.update())
    {
        // 将NTP获取到的时间同步到ESP32系统时钟
        unsigned long epochTime = timeClient.getEpochTime();
        struct timeval tv;
        tv.tv_sec = epochTime;
        tv.tv_usec = 0; // NTP仅到秒级，微秒设为0
        
        settimeofday(&tv, NULL);
        
        this->print("NTP时间更新成功");
        this->print("系统时间已同步：" + getDateTime());
        this->print("NTP格式化时间：" + timeClient.getFormattedTime());
    }
}

关键修改说明 #

1. 同步系统时钟：在timeClient.update()返回true（即成功获取NTP时间）后，调用settimeofday()将NTP时间戳写入系统时钟，确保gettimeofday()能读取到正确时间。
2. 时区配置：在setup()中通过setenv()和tzset()设置本地时区，让localtime()转换出正确的本地时间格式。
3. 非阻塞保证：NTPClient的update()方法仅在到达设定的更新间隔（默认60秒）时才会发起NTP请求，其余时间直接返回false，不会长时间阻塞主循环，符合非阻塞要求。

内容的提问来源于stack exchange，提问作者Mendes