今天记录一下使用 ABP CLI 6.x 版本创建纯后端 API 项目的完整流程,不需要 UI、不需要主题、指定 MySQL 数据库,同时解决版本不匹配报错、目录结构等问题。
一、环境准备
- 安装 .NET 6 SDK
- 安装 MySQL 数据库
- 安装对应版本 ABP CLI
二、安装 / 切换 ABP CLI 6.x
# 卸载旧版本
dotnet tool uninstall -g Volo.Abp.Cli
# 安装 6.0.3 稳定版
dotnet tool install -g Volo.Abp.Cli --version 6.0.3
# 查看版本
abp --version
三、创建项目命令(无 UI + MySQL + 无主题)
项目名称:jiujiusijiApi
abp new jiujiusijiApi --no-ui -dbms MySQL -m none --version 6.0.0
带连接字符串一键创建:
abp new jiujiusijiApi --no-ui -dbms MySQL -m none --version 6.0.0 --connection-string "Server=localhost;Port=3306;Database=jiujiusijiApi;Uid=root;Pwd=你的密码;" -csf
四、常见问题说明
- 报错:Object reference not set to an instance of an object
- 原因:CLI 版本过低(如 5.x)去创建 6.x 项目导致不兼容
- 解决:必须将 CLI 升级到 6.x 再创建
- 为什么生成 aspnet-core 目录?
- ABP 6.x 模板默认结构,用于前后端分离规范
- 不想用此目录可改用 ABP 5.x 版本创建
- 关于主题
- 使用
--no-ui即无任何前端、无主题依赖 - 纯 API 项目无需 LeptonX 等任何主题
- 使用
五、总结
- ABP CLI 版本必须与创建项目的框架版本匹配
- 纯 API 项目使用
--no-ui最干净 - MySQL 可直接在创建命令中指定连接字符串
- 6.x 模板默认带
aspnet-core目录,属于正常结构