ESP8266 Arduino环境下使用<Time.h>库无法从NTP服务器获取时间

问题原因与修复方案 #

• 配置文件名拼写错误
  你标注的platformio.int文件名错误，正确应为platformio.ini，如果文件名写错PlatformIO不会加载对应配置，可能引发运行异常。
• 未校验WiFi连接状态
  调用WifiControl.setWifi()后未判断WiFi是否真正连接成功，仅热点显示设备接入不代表网络协商已经完成，需要添加连接状态校验逻辑，确认设备拿到IP后再执行NTP同步。
• NTP同步未加等待逻辑
  ESP8266 Arduino核心的configTime是异步调用，触发NTP请求后不会阻塞等待同步完成，调用后立刻执行time(nullptr)大概率只能拿到初始时间戳（1970年起始值），需要添加等待同步完成的循环逻辑。
• 第三方Time库冗余
  你引入的paulstoffregen/Time库和ESP8266核心自带的时间API功能重叠，当前代码里用到的configTime、time()、gmtime_r都是核心自带的API，完全用不到第三方Time库，建议删除该依赖和对应的#include <Time.h>代码，避免命名冲突。

修改后的参考代码 #

#include <Arduino.h>
#include <ESP8266WiFi.h>
#include "WifiCtrl.h"   // Wifi setup
WifiCtrl WifiControl;

void setup()
{
    Serial.begin(9600);

    // WiFi连接并校验状态
    WifiControl.setWifi();
    // 等待WiFi连接成功，最长等待15秒
    int waitCnt = 0;
    while (WiFi.status() != WL_CONNECTED && waitCnt < 30) {
        delay(500);
        Serial.print(".");
        waitCnt++;
    }
    if (WiFi.status() != WL_CONNECTED) {
        Serial.println("\nWiFi连接失败");
        return;
    }
    Serial.println("\nWiFi连接成功，IP：" + WiFi.localIP().toString());

    // 配置NTP并等待同步
    configTime(5 * 3600, 1800, "pool.ntp.org", "time.nist.gov");
    time_t now;
    // 最长等待10秒同步完成
    int ntpWait = 0;
    while ((now = time(nullptr)) < 24 * 3600 && ntpWait < 20) {
        delay(500);
        Serial.print("o");
        ntpWait++;
    }
    if (now < 24 * 3600) {
        Serial.println("\nNTP同步失败");
        return;
    }

    struct tm timeinfo;
    gmtime_r(&now, &timeinfo);
    Serial.print("\nCurrent time: ");
    Serial.print(asctime(&timeinfo));
}

void loop() {}

platformio.ini 优化建议 #

可以移除冗余的Time库依赖，修改后如下：

board_build.f_cpu = 160000000L
platform = espressif8266
board = nodemcuv2
framework = arduino

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