Windows环境下如何通过Python获取UDP数据包的内核时间戳

首先给出明确结论：可以实现，Windows Vista/Server 2008及以上版本内核原生支持UDP数据包接收时间戳，可通过Python标准库socket直接调用相关接口完成实现，无需依赖第三方组件。

核心实现逻辑 #

• Windows平台的套接字支持SO_TIMESTAMP选项（专属常量值为0x0008），开启后内核会将数据包到达的时间戳附在报文的控制消息中一同返回
• Python 3.3及以上版本的标准库socket已原生支持Windows平台的recvmsg调用，可直接提取控制消息中的时间戳字段
• Windows返回的时间戳为FILETIME格式，单位为100纳秒，起始时间为1601年1月1日，需要手动转换为常用的Unix时间戳格式

可运行示例代码 #

import socket
import struct

# 监听配置
LISTEN_IP = "0.0.0.0"
LISTEN_PORT = 12345
BUFFER_SIZE = 4096

# 创建UDP套接字
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)
sock.bind((LISTEN_IP, LISTEN_PORT))

# 开启Windows平台时间戳选项
SO_TIMESTAMP = 0x0008
sock.setsockopt(socket.SOL_SOCKET, SO_TIMESTAMP, 1)

print(f"UDP服务已启动，监听{LISTEN_IP}:{LISTEN_PORT}")
while True:
    # 接收数据与控制消息
    data, ancdata, _, addr = sock.recvmsg(BUFFER_SIZE, BUFFER_SIZE)
    recv_timestamp = None

    # 遍历控制消息提取内核时间戳
    for cmsg_level, cmsg_type, cmsg_data in ancdata:
        if cmsg_level == socket.SOL_SOCKET and cmsg_type == SO_TIMESTAMP:
            # 解析FILETIME并转换为Unix时间戳（单位：秒）
            filetime = struct.unpack("<Q", cmsg_data)[0]
            recv_timestamp = (filetime - 116444736000000000) / 10000000
            break

    # 输出结果
    print(f"\n收到来自{addr}的报文：{data.decode('utf-8', errors='replace')}")
    if recv_timestamp:
        print(f"内核接收时间戳：{recv_timestamp:.6f}")

注意事项 #

• 仅支持Windows Vista/Server 2008及以上版本的系统，更低版本无对应内核特性支持
• 时间戳精度取决于系统时钟分辨率，常规场景下可达到10~100微秒级别
• 若需要更高精度的时间戳，可通过调用npcap/WinPcap驱动接口实现，适合网络抓包类场景使用

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