/文档/故障排查

故障排查

遇到问题?按照以下步骤排查常见故障。

🚫 部署失败

1. 检查项目结构

确保项目结构符合模板要求:

🐍 FastAPI

  • main.py(入口文件)
  • requirements.txt
  • app = FastAPI()

⚛️ Next.js

  • package.json
  • build 脚本
  • start 脚本

2. 查看构建日志

在项目详情页查看构建日志,找到具体错误信息。常见错误包括:

ModuleNotFoundError缺少依赖
SyntaxError代码语法错误
npm ERR!Node.js 依赖问题

3. 检查依赖文件

# requirements.txt 示例
fastapi==0.104.1
uvicorn==0.24.0
# 确保版本号正确,避免冲突

🌐 应用无法访问

1. 检查项目状态

状态说明解决方案
sleeping休眠中访问后自动唤醒
stopped已停止手动启动
failed部署失败查看日志修复

2. 检查端口配置

确保应用监听正确的端口:

# FastAPI - 必须监听 8000 端口
uvicorn main:app --host 0.0.0.0 --port 8000

# Next.js - 必须监听 3000 端口
# package.json 中的 start 脚本会自动处理

性能问题

响应慢

  • • 检查资源使用情况
  • • 优化数据库查询
  • • 添加缓存机制
  • • 升级套餐

内存不足

  • • 减少并发连接数
  • • 优化代码避免内存泄漏
  • • 升级 Pro 套餐(512MB)

🗄️ 数据库问题

连接失败

  • • 检查 DATABASE_URL 环境变量
  • • 确认数据库已创建
  • • 检查连接字符串格式

存储已满

Pro 套餐数据库限制 512MB。清理不需要的数据或联系客服扩容。

📋 日志排查技巧

常见日志关键词

ERROR

错误信息

WARN

警告信息

Connection refused

连接被拒绝

Timeout

超时

Out of memory

内存不足

Permission denied

权限不足

💡 还是无法解决?

发送邮件到 support@nomoo.top, 附上项目 ID 和错误日志,我们会尽快帮你解决。