常见报错怎么处理

ModuleNotFoundError: No module named ‘fastapi’

依赖没装进当前环境。先确认命令行前面有 (venv)，没有就重新激活虚拟环境，再执行 pip install -r requirements.txt。

pip 报 httpx 版本冲突

打开 requirements.txt，把 httpx==0.27.0 改成 httpx>=0.28.1，保存后重新安装。这个冲突会让 pip install 直接失败。

端口 8010 被占用

打开 .env，把 PORT=8010 改成别的端口，比如 8011，重启后访问 http://localhost:8011。

不要直接去任务管理器结束不认识的进程，先确认占用端口的是不是这个程序。

创建主账号时报 422

邮箱格式不合法。用真实域名，比如 you@example.com；.local 这类保留域名会被校验拦下。

邮箱登录失败 / 发不出邮件

大多数企业邮箱要用授权码，不是网页登录密码。检查 .env 里的 SMTP 和 IMAP 四项：服务器、端口、账号、授权码。

阿里企业邮箱通常是 smtp.qiye.aliyun.com:465 和 imap.qiye.aliyun.com:993；其他服务商以官方说明为准。

AI 评分没反应

依次检查：Key 有没有填、余额够不够、国内访问 Gemini 有没有配 HTTPS_PROXY、改完 .env 有没有重启程序。

浏览器打不开页面

先看命令行窗口：服务是不是还在运行、有没有报错退出。服务没起来，浏览器当然打不开。确认端口号和你访问的地址一致。

重启后数据不见了

检查三件事：.env 里的 DATABASE_URL 指向哪个文件、你是不是在同一个项目目录启动的、数据库文件还在不在。换过目录或改过配置，最常见。