常见问题

控制器未生效

• 文件名需满足 *Controller.ts
• 确认类已导出
• 查看启动日志是否有加载错误

热更新不工作

• 必须使用 npm run dev 启动
• 确认改动位于 src 目录
• 避免动态 require 导致监听失效

数据库连接失败

• 检查 MySQL 服务状态
• 检查数据库账号权限
• 验证 .env 中连接参数

Redis 连接失败

• 检查 Redis 服务与密码
• 核对主机、端口、DB 编号
• 单机开发可先临时关闭 Redis 相关功能