移除Clerk后Next.js项目middleware.ts警告仍存在，阻碍生产部署

开发者阿泽

2026-7-13

解决移除Clerk后仍出现认证警告的问题

以下是排查和解决步骤：

清理Next.js构建缓存
旧构建缓存可能残留Clerk代码，执行命令删除缓存目录：
```
rm -rf .next
```
Windows系统使用：
```
rmdir /s /q .next
```
彻底清除Clerk依赖残留
检查package-lock.json或yarn.lock文件，确认无@clerk/nextjs及相关Clerk包条目，若有手动删除后重新安装依赖：
```
npm install
```
检查并清理中间件文件
查看项目根目录的middleware.ts/middleware.js，若之前用过Clerk的authMiddleware，务必删除所有相关代码，包括导入语句、中间件导出逻辑。
移除Clerk相关环境变量
检查.env、.env.production等环境变量文件，删除所有Clerk相关变量（如NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY、CLERK_SECRET_KEY）。
清理npm缓存
执行命令清除npm缓存，避免残留包文件影响：
```
npm cache clean --force
```
检查next.config.js配置
确认next.config.js中无Clerk相关配置项，若有则移除。