64 lines
2.1 KiB
Markdown
64 lines
2.1 KiB
Markdown
# Spacetime 开发连接地址热修 2026-04-20
|
||
|
||
## 背景
|
||
|
||
当前前端账号、存档和资料库链路已经切到 SpacetimeDB。
|
||
|
||
但本地开发默认配置存在一处关键错配：
|
||
|
||
- 默认数据库名是 maincloud 上的 `xushi-p4wfr`
|
||
- 默认 `VITE_SPACETIME_URI` 却写成了 `ws://127.0.0.1:3000`
|
||
- 同时 `npm run dev` 的 Vite 开发服也默认占用 `127.0.0.1:3000`
|
||
|
||
结果是页面启动后，浏览器会把账号 WebSocket 误连到 Vite，而不是实际的 SpacetimeDB 服务。
|
||
|
||
这会直接表现为：
|
||
|
||
- 页面长时间停留在“正在建立账号连接...”
|
||
- 或者账号连接相关逻辑异常，但 `npm run dev` 终端表面上看起来前后端都已经启动
|
||
|
||
## 根因
|
||
|
||
本次问题不是 `server-node` 编译失败，而是前端默认环境变量错误：
|
||
|
||
- `src/spacetime/client.ts` 内置默认 URI 错误
|
||
- `.env.example` 示例值错误
|
||
- `scripts/dev-node.mjs` 没有把正确的 Spacetime 默认值显式注入启动环境
|
||
|
||
## 修复
|
||
|
||
本次做了三处最小修复：
|
||
|
||
1. `src/spacetime/client.ts`
|
||
|
||
- 默认 `VITE_SPACETIME_URI` 改为 `wss://maincloud.spacetimedb.com`
|
||
- 默认数据库名继续保持 `xushi-p4wfr`
|
||
|
||
2. `scripts/dev-node.mjs`
|
||
|
||
- 当本地未配置时，自动注入：
|
||
- `VITE_SPACETIME_URI=wss://maincloud.spacetimedb.com`
|
||
- `VITE_SPACETIME_DATABASE_NAME=xushi-p4wfr`
|
||
- 启动日志增加当前使用的 Spacetime URI 和数据库名，便于排查
|
||
|
||
3. `.env.example`
|
||
|
||
- 示例值改为 maincloud URI
|
||
- 补充说明：若要连本地 `spacetime start`，需在 `.env.local` 中显式覆盖为 `ws://127.0.0.1:3000`
|
||
|
||
## 验证
|
||
|
||
已完成：
|
||
|
||
- `npm run dev`
|
||
- Vite 正常启动到 `http://127.0.0.1:3000`
|
||
- `server-node` 正常启动到 `:8081`
|
||
- 启动日志会明确打印当前 `VITE_SPACETIME_URI` 与 `VITE_SPACETIME_DATABASE_NAME`
|
||
- `npm run check:encoding`
|
||
|
||
## 结论
|
||
|
||
默认开发链路现在会优先连到和默认数据库名一致的 maincloud Spacetime 服务，不再把账号连接误打到本地 Vite 端口。
|
||
|
||
如果后续要切回本地 SpacetimeDB，只需要在 `.env.local` 中显式覆盖 URI，不需要再改代码。
|