sleep_ms 原用 #[cfg(not(target_arch = "wasm32"))] guard tokio::time::sleep, 但 tokio 是 server-only 的 optional 依赖。此 guard 会在「非 wasm32 主机 + 仅 web feature」组合(如 cargo build --no-default-features --features web)下 误激活,此时 tokio 未引入,导致编译失败。 该 bug 长期被 [dev-dependencies] tokio 掩盖——cargo test / 开发构建总能拿到 tokio,只有发布/生产构建(排除 dev-deps)才暴露。符合 AGENTS.md 第 1 条 dual-target gating 标准:触及 server-only 依赖的代码必须用 #[cfg(feature = "server")] 而非 target_arch 区分。 修复:tokio 版本改为 #[cfg(all(feature = "server", not(target_arch = "wasm32")))], 并为无效构建组合「非 wasm32 且非 server」补一个 panic stub(该组合不是有效部署 目标,web feature 真实构建目标即 wasm32;stub 仅保证符号可编译,运行时不会触发)。 调用点 runner.rs 的 server 占位分支(通过 sleep_ms 继承同一问题)无需改动—— 它只在 server target 下编译运行,sleep_ms 修复后其调用自然可编译。
Yggdrasil
基于 Dioxus 0.7 的全栈博客系统,Rust 单一代码库同时编译为 WASM 前端和原生服务端。
技术栈
- 框架: Dioxus 0.7 (fullstack)
- 数据库: PostgreSQL + tokio-postgres
- 样式: Tailwind CSS v4
- 密码: Argon2
- 会话: UUID token + cookie
功能
- 邮箱注册 / 登录(单管理员模式,首次注册后关闭)
- 会话管理与自动过期清理
- 暗色 / 亮色主题切换
- 后台文章撰写(Tiptap Markdown 编辑器)
- 文章归档与标签浏览
开发
依赖 Rust 1.95+、wasm32 目标、dx CLI、tailwindcss CLI v4 和 PostgreSQL。
# 配置数据库
DATABASE_URL=postgres://postgres:postgres@localhost:5432/yggdrasil
# 运行迁移(自动创建数据库并按顺序执行 migrations/ 下所有 SQL)
./migrate.sh
# 启动开发服务器
make dev
构建
make build
生产部署
生产环境必须前置反向代理(nginx/Caddy)做 TLS 终结,并设置 APP_BASE_URL、
COOKIE_SECURE=true、TRUSTED_PROXY_COUNT=1。详见 部署指南。
Description
Languages
Rust
77.4%
TypeScript
17.2%
CSS
3.3%
Dockerfile
0.9%
Makefile
0.6%
Other
0.6%