后端启动日志位置——三个路径记住一个就够
三种部署方式的日志位置
| 部署方式 | 日志位置 |
|---|---|
| 桌面端 macOS | ~/Library/Application Support/MateClaw/logs/mateclaw.log |
| 桌面端 Windows | %APPDATA%\MateClaw\logs\mateclaw.log |
| Docker | docker compose logs mateclaw-server（容器标准输出） |
| JAR / mvn | 终端标准输出，或 Spring Boot 默认的 logs/mateclaw.log |
日志里最重要的几行
后端启动失败时，日志最后 50 行里通常能看到根因：
- 端口被占：
Port 18088 was already in use→ 改端口 - 数据库连不上：
Connection refused或 PostgreSQL 相关报错 → 检查数据库是否启动、密码是否对 - H2 锁文件：
Database lock acquisition failure→ 删.lock文件或清空data/ - JWT secret 太短：
JWT secret must be at least 32 characters→ 改 secret
Docker 场景额外看 PostgreSQL 日志
MateClaw 在 Docker 里依赖 PostgreSQL（还有可选的 SearXNG）。MateClaw 起不来不一定是它自己的问题——可能 PostgreSQL 还没准备好。
docker compose logs postgres 看 PostgreSQL 是不是正常启动了。等它 ready 之后 MateClaw 会自动连上。
日志保留与清理
MateClaw 的滚动日志策略以官方最新版为准。开发/测试模式下日志量小；生产模式下建议配置日志轮转（Docker 的 log-driver 或宿主机的 logrotate），不要让日志把磁盘占满。