From e62c2211929b8bd88679433108bbac504a426a3c Mon Sep 17 00:00:00 2001
From: undefined <i@undefined.moe>
Date: Mon, 16 Feb 2026 15:46:40 +0800
Subject: [PATCH] fix(webui): check_port_available: enable SO_REUSEADDR option

Allow binding in TIME_WAIT state to reduce false positives (occurs when app restarts).
---
 src/webui/webui_server.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/webui/webui_server.py b/src/webui/webui_server.py
index 7e2afbb5..00ea6054 100644
--- a/src/webui/webui_server.py
+++ b/src/webui/webui_server.py
@@ -89,6 +89,8 @@ class WebUIServer:
         try:
             with socket.socket(family, socket.SOCK_STREAM) as s:
                 s.settimeout(1)
+                # 与 Uvicorn 一致：允许在 TIME_WAIT 状态下绑定，减少误报
+                s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
                 # 尝试绑定端口
                 s.bind((test_host, self.port))
                 return True