Payload非默认Admin集合下first-register端点返回404问题

针对你遇到的/api/admin/first-register返回404的问题，按以下顺序排查：

1. 确认Admin集合已加入Payload配置的collections数组 #

Payload只会加载payload.config.ts中collections数组里的集合，若未添加Admin集合，对应的API路由不会生成。检查配置文件：

// payload.config.ts
import { buildConfig } from 'payload/config';
import Admin from './collections/Admin'; // 确保路径正确

export default buildConfig({
  admin: {
    user: Admin.slug,
    importMap: {
      baseDir: path.resolve(__dirname)
    }
  },
  collections: [
    Admin, // 必须添加这一行
    // 其他集合比如Students
  ],
  // 其他配置
});

2. 验证Admin集合的auth配置未禁用本地策略 #

first-register路由依赖本地认证策略，若Admin集合auth配置中设置了disableLocalStrategy: true，会导致路由失效。检查Admin集合的auth配置：

const Admin: CollectionConfig = {
  auth: {
    maxLoginAttempts: 5,
    lockTime: 600000,
    // 确保没有这行：disableLocalStrategy: true
  },
  slug: 'admin',
  // 其他配置
};

3. 确认Admin.slug在payload.config.ts中可正确访问 #

若Admin集合的导入路径错误，或slug属性拼写错误，会导致Admin.slug的值不正确，Payload无法识别对应的集合路由。可在payload.config.ts中打印验证：

console.log('Admin slug:', Admin.slug); // 应输出 'admin'

如果输出为空或错误，检查Admin集合文件中slug的拼写，以及导入语句的路径是否正确。

4. 检查Payload版本兼容性 #

不同版本的Payload，first-register路由格式可能不同：

• Payload 2.x版本路由格式为/api/[collection-slug]/first-register
• 1.x版本则为/api/first-register（不带集合slug）

查看package.json中的payload版本：

{
  "dependencies": {
    "payload": "^2.0.0" // 确认版本与路由格式匹配
  }
}

若为1.x版本，需调整前端跳转路径，或升级到2.x版本并对应调整配置。

5. 清除缓存并重启服务 #

Payload的缓存可能导致路由未正确生成，尝试删除.payload目录（若存在），再重启开发服务器：

rm -rf .payload
npm run dev

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