常见问题

Codesandbox 预览

Codesandbox 可能会要求你确认以继续。你可以通过切换到 onlook 中的预览模式，点击“是，继续预览”链接，然后切换回来。之后，UI 应该会在 iframe 内正确渲染。

认证问题

如果你遇到重载页面后未认证的问题，请检查你的 Node 版本，安装较新的版本，重新安装依赖并重启项目。 推荐最低版本为 v20.16.0 或更高版本。

避免使用 Node 版本 v20.11.0，因为该版本曾出现过此问题。

node --version

你可能需要删除 cookies 以清除认证状态。

“找不到列”错误

如果你遇到类似“找不到列”的错误，说明你的数据库可能与架构不同步。可以尝试以下两种方法使其重新同步：

1. 运行 bun db:push 将架构推送到数据库。如果存在冲突，可以尝试第二步。
2. 运行 bun db:reset 完全重置数据库并重新运行迁移。警告：这会删除数据库中的所有数据。

预加载脚本测试

如果你想更新预加载脚本并在 Onlook 中测试，按照以下步骤进行：

1. 在项目根目录运行 bun run dev。
2. 将文件 apps/web/client/public/onlook-preload-script.js 复制到 onlook 或 codesandbox 接口代码标签中的 public/onlook-preload-script.js。
3. 刷新 localhost 标签页。现在你应该能够测试预加载脚本。

如果你想更新预加载脚本并测试任何更改，需要刷新 localhost 标签页。