Strapi首次管理员用户注册失败（400错误）求助

系统环境 #

• Strapi V4.5.6
• Windows 10
• SQLite
• Node v16.17.0
• NPM 8.15.0
• Yarn 1.22.19

按照官方快速入门指南创建新项目后，在管理员注册页填写完整有效信息（含合规邮箱），点击「Let’s start」按钮时出现400请求错误，无法完成首个管理员账号创建。已查阅官方文档，未找到对应解决方案。

可行排查/解决步骤 #

1. 确认密码符合复杂度要求 #

Strapi默认对初始管理员密码有强制复杂度规则，需满足：

• 最少8位长度
• 同时包含大写字母、小写字母、数字、特殊符号中的至少三类

2. 清理缓存并重建项目 #

执行以下操作后重启项目：

# 清理包管理器缓存
yarn cache clean
# 或用npm
npm cache clean --force

# 删除Strapi生成的缓存与构建文件（Windows命令）
rmdir /s /q .build .cache

# 重启开发服务
yarn develop
# 或用npm
npm run develop

3. 检查本地Hosts配置 #

确保localhost正确指向127.0.0.1：

1. 打开C:\Windows\System32\drivers\etc\hosts文件
2. 确认存在该行（无则添加）：

   127.0.0.1 localhost
   

4. 更换端口启动服务 #

默认端口1337可能被其他程序占用，尝试指定其他端口启动：

yarn develop --port 1338
# 或用npm
npm run develop -- --port 1338

5. 切换Node LTS版本 #

虽然v16.17.0在兼容范围内，但部分细微版本差异可能引发问题，切换到Node v16的LTS稳定版（如v16.20.2）后重新测试。

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