base44-troubleshooter

排查生產環境問題

前置條件

在擷取日誌前，請先驗證身分驗證狀態：

npx base44 whoami

如果未通過驗證或 Token 已過期，請指示使用者執行 npx base44 login。

請透過以下其中一種方式解析應用程式上下文：

# 從已連結的本機專案
cat base44/.app.jsonc

# 或明確指定
npx base44 logs --app-id app_123

可用指令

指令	說明	參考文件
base44 logs	擷取此應用程式的函式日誌	project-logs.md

排查流程

1. 檢查近期錯誤

首先，擷取所有函式的最新錯誤：

npx base44 logs --level error

2. 深入特定函式

如果你知道是哪個函式出錯：

npx base44 logs --function <function_name> --level error

如果你不在專案目錄中，請明確指定應用程式：

npx base44 logs --app-id app_123 --function <function_name> --level error

3. 檢查特定時間範圍

與使用者回報的問題時間戳進行比對：

npx base44 logs --function <function_name> --since <start_time> --until <end_time>

4. 分析日誌

• 在輸出中尋找堆疊追蹤與錯誤訊息
• 檢查時間戳以比對使用者回報的問題
• 如果預設的 50 筆不夠，請使用 --limit 擷取更多項目