日志与排查（dev）
快速入口
| 工具 | 地址 |
|---|---|
| Dev 控制台（实时） | https://back.dev.yuriful.top/dev/console.html |
| 健康检查 JSON | https://back.dev.yuriful.top/dev/api/health |
| 内存错误列表 | GET /dev/api/logs/errors?limit=100 |
| 应用日志 tail | GET /dev/api/logs/app?lines=200 |
| OpenAPI 契约 | /doc/openapi.json（本站点） |
本地：http://localhost:8090/dev/console.html
日志文件
| 文件 | 说明 |
|---|---|
logs/error.log |
所有 4xx/5xx 响应（全 profile 生效） |
logs/app.log |
应用运行日志（dev 部署常为 /data/TdmServerRust/logs/app.log） |
error.log 每条含：时间、Method、完整 /api 路径、状态码、组员 ID、响应 body。
性能分析（仅 dev / dev-h2）
启动：cargo run -- --profile dev
| 环境变量 | 说明 |
|---|---|
RUST_LOG |
默认 tdm_server_rust=debug |
DEV_PROFILE_MIN_MS |
隐藏 self 低于阈值的 span（ms），默认 0.1 |
DEV_PROFILE_LINK_SCHEME |
jetbrains / cursor / vscode / file |
DEV_SERVER_TIMING |
设为 0 关闭响应头 Server-Timing |
DEV_LOG_DIR / DEV_APP_LOG |
覆盖日志路径 |
控制台 prof │ 前缀为调用栈耗时树；self 最大行带 ◀ hot。
前端 DevTools → Network → 响应头 Server-Timing；控制台 [api-timing] 含 queueMs 与 server=[...]。
常见问题
| 现象 | 排查 |
|---|---|
API 400 + missing field |
Query 缺参（如收藏接口缺 memberId）；对照 OpenAPI |
| API 401 | Token 过期或未登录 |
| API 500 | 查 error.log 与 dev 控制台 Errors |
| 前端慢 / queue 高 | 看 Server-Timing 的 hot；对比 Java/Rust 双端 |
| Swagger 白屏 | 用本站点 /swagger-ui，勿混用旧 CDN 缓存 |
远程 dev SSH
tail -f /data/TdmServerRust/logs/error.log
tail -f /data/TdmServerRust/logs/app.log