用途:在局域网(LAN)环境中,将 React + NestJS + Postgres 的 Web 应用迁移为 Tauri 桌面应用,按顺序执行以降低迁移风险。
推荐流程:规划迁移;在 backend/frontend/tauri 中实施改动;通过日志验证安装初始化、登录与 CRUD;准备可安装的 release。
局域网强制规则:桌面端后端始终本地监听 127.0.0.1;数据库远程连接使用服务器固定 IP,配置项为 database.host;LAN 客户端中不要用 localhost 作为数据库主机。
优先查看的日志路径:%APPDATA%/sistema-caja/debug_startup.log;%APPDATA%/sistema-caja/logs/error-YYYY-MM-DD.log;%APPDATA%/sistema-caja/logs/application-YYYY-MM-DD.log。
常见错误快速诊断:Cannot POST /api/config/test 表示后端处于正常模式而非 setup 模式;failed to fetch 表示后端宕机或重启中(启动竞态);解析配置时 Unexpected token 表示文件带 BOM(如 config.json);os error 2 表示 sidecar 路径或名称解析错误;os error 32 表示文件在解压/使用中被锁;Nest can't resolve JwtAuthGuard (JwtService) 表示对应 auth 模块未正确导入/导出。
最小验证清单:初始 setup 能打开并保存配置;登录可用 sidecar 后端;关键 CRUD 能通过 IP 连接远程数据库正常工作;启动日志无阻塞性错误。
Go/No-Go 判定:当 setup + 登录 + CRUD + 日志均稳定时执行;出现 sidecar 错误、后端宕机或认证/数据库失败时不执行。
限制:本条资料未提供具体安装命令、版本要求、定价或平台支持细节,相关事实暂未提供。