准备部署

2026-06-15 21:21:20 +08:00
parent 4167714149
commit 6c22cf9ef7
17 changed files with 898 additions and 2 deletions
@@ -73,4 +73,9 @@ class ConnectionManager:


 # 全局单例
+# ⚠️ 重要约束：本管理器为「进程内存」单例 —— active_connections 只存在于
+#    当前进程。因此后端必须以「单进程」方式运行（生产镜像 Dockerfile.prod
+#    已固定为单 worker uvicorn）。若使用 --workers N 或 gunicorn 多 worker，
+#    连接会分散到不同进程，跨用户 / 跨标签页的实时消息（聊天、撤回、好友请求、
+#    互动通知等）将无法投递。水平扩展前需先将其迁移到基于 Redis 的 pub/sub。
 manager = ConnectionManager()