fix: resolve 404 error after long-term running by persisting static files and adding SPA fallback

Author: rust17

server/src/server/config.py

@@ -1,4 +1,5 @@
 import sys
+import shutil
 from pathlib import Path
 from loguru import logger
 
@@ -23,10 +24,24 @@ def get_share_dir() -> Path:
 
 
 def get_static_dir() -> Path:
-    # 1. PyInstaller environment: points to sys._MEIPASS/web_dist
+    # 1. PyInstaller environment
     if getattr(sys, "frozen", False):
         bundle_dir = Path(sys._MEIPASS)
-        static_dir = bundle_dir / "web_dist"
+        source_static = bundle_dir / "web_dist"
+        
+        # Target: ~/.remote-mouse/web_dist (Persistent storage to avoid /tmp cleanup)
+        target_static = get_share_dir() / "web_dist"
+        
+        try:
+            # Sync files to persistent directory
+            if target_static.exists():
+                shutil.rmtree(target_static)
+            shutil.copytree(source_static, target_static)
+            logger.info(f"Static files synced to: {target_static}")
+            return target_static
+        except Exception as e:
+            logger.error(f"Failed to sync static files to persistent storage: {e}")
+            return source_static  # Fallback to temporary one
     else:
         # 2. Dev environment: points to ../../../web-client/dist
         # project_root is server/ (where pyproject.toml is)

server/src/server/services/manager.py

@@ -1,4 +1,5 @@
 import threading
+import socket
 import uvicorn
 from loguru import logger
 
@@ -26,6 +27,15 @@ def set_debug(self, debug: bool):
     def start(self):
         logger.info(f"Starting services (Debug: {self.debug})...")
         try:
+            # 0. Check if port is already in use
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                try:
+                    s.bind(("0.0.0.0", self.port))
+                except socket.error:
+                    error_msg = f"Port {self.port} is already in use by another process."
+                    logger.error(error_msg)
+                    raise RuntimeError(error_msg)
+
             # 1. Start mDNS
             self.mdns = MDNSResponder(port=self.port)
             self.mdns.register()

server/src/server/services/web.py

@@ -1,5 +1,7 @@
-from fastapi import FastAPI, WebSocket, WebSocketDisconnect
+from fastapi import FastAPI, WebSocket, WebSocketDisconnect, Request
 from fastapi.staticfiles import StaticFiles
+from fastapi.responses import FileResponse, JSONResponse
+from starlette.exceptions import HTTPException as StarletteHTTPException
 from loguru import logger
 
 from server.core.protocol import process_binary_command
@@ -26,6 +28,17 @@ async def websocket_endpoint(websocket: WebSocket):
         except Exception as e:
             logger.error(f"WebSocket error: {e}")
 
+    # SPA Fallback for 404 errors
+    @app.exception_handler(404)
+    async def not_found_handler(request: Request, exc: StarletteHTTPException):
+        index_path = static_dir / "index.html"
+        if index_path.exists():
+            logger.debug(f"404 for {request.url.path}, falling back to index.html")
+            return FileResponse(index_path)
+        
+        logger.warning(f"404 for {request.url.path} and index.html not found in {static_dir}")
+        return JSONResponse({"detail": "Not Found"}, status_code=404)
+
     # 挂载静态文件（必须放在最后，否则可能覆盖 API 路由）
     if static_dir.exists():
         app.mount("/", StaticFiles(directory=str(static_dir), html=True), name="static")