如何重建无法运行的旧Adonis项目？

1. 解决npm run build脚本缺失问题 #

你的package.json中未定义build脚本，这是运行报错的直接原因。结合项目现有脚本的功能，可以将build设置为整合依赖安装与邮件模板编译的组合脚本，在scripts节点中添加：

"build": "npm install && npm run emails:html"

如果仅需编译邮件模板，直接执行npm run emails:html即可——该脚本负责把tmpl-emails目录下的MJML文件转译为Nunjucks模板，输出到resources/views/emails目录。

2. 完整重建步骤 #

环境准备 #

• 安装Node.js（建议v8.x版本，适配Adonis v3的依赖兼容要求）
• 确保npm/yarn可用

依赖安装 #

在项目根目录执行：

npm install

若遇依赖冲突或安装失败，清理缓存后重试：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

环境变量配置 #

复制.env.example（若存在）为.env，手动填写数据库连接、邮件服务等必要配置：

cp .env.example .env

数据库初始化 #

执行迁移脚本创建数据库表结构：

./ace migration:run

注意：需确保.env中的数据库配置正确，且目标数据库已提前创建。

启动服务 #

开发环境（监听文件变化自动重启）：

npm run dev

生产环境：

npm run start

代码规范检查（可选） #

执行代码风格校验：

npm run lint

测试用例执行（可选） #

运行测试套件（自动执行迁移→测试→回滚迁移）：

npm run test

3. 常见故障排查 #

• 依赖安装失败：部分旧包可能在默认npm源无法下载，可切换至国内源重试；若仍失败，手动指定包版本重新安装。
• 服务启动报错：检查.env配置正确性、数据库服务是否启动、端口是否被占用。
• Adonis命令无法执行：给./ace文件添加执行权限：chmod +x ./ace。

内容的提问来源于stack exchange，提问作者DevonDahon