必须先调用netif_set_up()确保NETIF_FLAG_UP和NETIF_FLAG_LINK_UP标志置位，否则dhcp_start()虽返回成功但无法发送Discover报文，导致IP获取失败。
嵌入式系统里调用 DHCP 客户端前必须确认 netif 状态
很多嵌入式项目一上来就调 dhcp_start()，结果卡住不动，根本不是函数没生效，而是网卡接口（struct netif*）还没完成底层初始化。LwIP 或者类似轻量协议栈中，netif_add() 之后必须显式调用 netif_set_up()，否则 DHCP 报文发不出去——连 Discover 都广播不出去，自然等不到 Offer。
常见错误现象：dhcp_start() 返回成功，但 ip_addr_isany(&netif->ip_addr) == 1 持续为真，且无任何 DHCP 日志输出。
- 检查
netif->flags是否包含NETIF_FLAG_UP | NETIF_FLAG_LINK_UP - 确保物理层已 link up（比如读取 PHY 寄存器或 MAC 的 MII 状态）
- 若使用 RTOS，确认 DHCP 超时回调（如
sys_timeout()）注册在正确的线程上下文中
静态 IP 切换不能只改 IP 地址，子网掩码和网关必须成对设置
只调 ip_addr_copy(netif->ip_addr, ipaddr) 是无效的。LwIP 中 IP 配置是三元组：IP、netmask、gw，缺一不可。漏设 netif->netmask 或 netif->gw，会导致路由表缺失默认网关，设备能 ping 通同网段但无法访问外网。
更隐蔽的问题是：某些芯片平台（如 STM32 HAL + LwIP）在切换模式时，需要手动清除旧的 DHCP 租约缓存，否则 dhcp_stop() 后再设静态 IP，仍可能残留 DHCP 的 DNS 或 metric 配置。
- 切静态前先执行
dhcp_stop(netif)，并等待其返回完成（部分移植需轮询netif->dhcp == NULL） - 三步赋值必须完整：
ip_addr_copy(netif->ip_addr, &static_ip)、ip_addr_copy(netif->netmask, &static_mask)、ip_addr_copy(netif->gw, &static_gw) - 调用
netif_set_addr(netif, &static_ip, &static_mask, &static_gw)比直接赋值更安全，它会触发底层 ARP 表刷新
DHCP 超时必须设，且 fallback 到静态 IP 不能硬编码
企业网络里 DHCP 响应延迟超过 30 秒很常见（尤其跨 VLAN、带 ACL 或启用了 DHCP Snooping）。如果代码里写死 sys_timeout(5000, ...)，设备大概率在客户现场反复“获取 IP 失败”，然后卡死或进入错误状态。
真实交付中，fallback 静态 IP 不能是固定值（如 192.168.1.100），而应从配置区读取一个预设的“应急网段”。比如出厂时烧录 fallback_net: 192.168.200.0/24，运行时自动分配 192.168.200.10 + device_id % 100，避免多台设备冲突。
- DHCP 超时建议设为 15–25 秒，太短易误判，太长影响启动体验
- 超时回调里不要直接调
set_static_ip()，先判断当前是否已存在有效 IP（!ip_addr_isany(&netif->ip_addr)），防止重复设置 - 切换后务必调用
dns_setserver(0, &dns_server)，否则即使 IP 正确，域名解析也会失败
Windows 嵌入式（如 Windows IoT Core）不适用 netsh，得走 UWP 网络 API
别被“嵌入式 Windows”误导。Windows IoT Core 或 Windows 10/11 IoT Enterprise 上，netsh interface ip set address 在非管理员权限下会静默失败，且 UWP 沙箱环境根本禁止执行 cmd.exe。这时候必须用 Windows::Networking::Connectivity::NetworkInformation 和 Windows::Networking::Connectivity::ConnectionProfile 这套 API，配合 NetworkAdapter 获取接口，再通过 ConnectionSession 提交配置。
难点在于：UWP 不允许直接设置 IPv4 地址，只能通过配置文件（.xml）导入，或依赖后台任务触发系统级网络重配。这意味着你无法在主线程里同步完成切换，必须设计状态机监听 NetworkStatusChanged 事件来确认生效。
- 调试时先用 PowerShell 手动验证：
Get-NetAdapter | Where-Object {$_.Status -eq 'Up'} | Set-NetIPInterface -Dhcp Enabled - UWP 应用需在
package.appxmanifest中声明networking和internetClientServer功能 - 没有管理员提权弹窗，所有网络变更都需用户提前授权（首次运行时弹出系统权限框）
实际工程中最容易被忽略的，是 DHCP fallback 后的 DNS 设置和 ARP 缓存清理——这两处不处理，设备看似有 IP，却既不能解析域名，也无法与网关通信。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
