feat: 增强桌面启动失败提示与测试覆盖

backend/cmd/desktop/port_test.go

@@ -9,87 +9,27 @@ import (
 	"time"
 )
 
-func TestCheckPortAvailable(t *testing.T) {
-	port := 19826
-
-	err := checkPortAvailable(port)
+func TestListenDesktopPortReturnsReusableListener(t *testing.T) {
+	listener, err := listenDesktopPort(0)
 	if err != nil {
-		t.Fatalf("端口 %d 应该可用: %v", port, err)
-	}
-
-	t.Log("端口可用测试通过")
-}
-
-func TestCheckPortOccupied(t *testing.T) {
-	port := 19827
-
-	listener, err := net.Listen("tcp", ":19827") //nolint:gosec // 需要验证 checkPortAvailable 对通配地址占用的检测行为
-	if err != nil {
-		t.Fatalf("无法启动测试服务器: %v", err)
+		t.Fatalf("listener-first 应直接获取配置端口 listener: %v", err)
 	}
 	defer listener.Close()
 
-	time.Sleep(100 * time.Millisecond)
-
-	err = checkPortAvailable(port)
-	if err == nil {
-		t.Fatal("端口被占用时应该返回错误")
-	}
-
-	t.Log("端口占用检测测试通过")
-}
-
-func TestCheckPortAvailableAfterClose(t *testing.T) {
-	port := 19828
-
-	listener, err := net.Listen("tcp", "127.0.0.1:19828")
-	if err != nil {
-		t.Fatalf("无法启动测试服务器: %v", err)
-	}
-
 	server := &http.Server{ReadHeaderTimeout: time.Second}
-	defer server.Close()
+	done := make(chan struct{})
 	go func() {
+		defer close(done)
 		err := server.Serve(listener)
 		if err != nil && err != http.ErrServerClosed && !errors.Is(err, net.ErrClosed) {
-			t.Errorf("serve failed: %v", err)
+			t.Errorf("使用同一个 listener 启动 server 失败: %v", err)
 		}
 	}()
 
-	time.Sleep(100 * time.Millisecond)
-
-	listener.Close()
-	time.Sleep(100 * time.Millisecond)
-
-	err = checkPortAvailable(port)
-	if err != nil {
-		t.Fatalf("端口关闭后应该可用: %v", err)
+	if err := server.Close(); err != nil {
+		t.Fatalf("关闭测试 server 失败: %v", err)
 	}
-
-	t.Log("端口关闭后可用测试通过")
-}
-
-func TestCheckPortAvailableErrorContainsPort(t *testing.T) {
-	port := 19829
-
-	listener, err := net.Listen("tcp", ":19829") //nolint:gosec
-	if err != nil {
-		t.Fatalf("无法启动测试服务器: %v", err)
-	}
-	defer listener.Close()
-
-	time.Sleep(100 * time.Millisecond)
-
-	err = checkPortAvailable(port)
-	if err == nil {
-		t.Fatal("端口被占用时应该返回错误")
-	}
-
-	if !strings.Contains(err.Error(), "19829") {
-		t.Fatalf("错误信息应包含端口号 19829，实际: %v", err)
-	}
-
-	t.Log("端口错误信息包含端口号测试通过")
+	<-done
 }
 
 func TestGetDesktopConfigPath(t *testing.T) {