Next.js应用部署至GAE失败：构建时提示找不到pages目录

排查方向及解决方案 #

1. 检查.gcloudignore配置 #

GAE部署时会根据.gcloudignore规则过滤上传文件，若该文件中存在pages/条目，会直接忽略pages目录，导致构建环境中缺失该目录。

打开.gcloudignore文件，确认没有如下内容：

pages/

若存在则删除该行，保存后重新执行部署命令。

2. 验证pages目录的有效性 #

本地项目结构显示存在pages目录，但需确认：

• 目录名称为全小写的pages（Next.js对目录名大小写敏感）
• 当前用户对该目录有读取权限

执行本地命令验证：

ls -la | grep pages

确认目录存在且权限正常。

3. 强制清理GAE构建缓存 #

远程构建缓存可能残留异常状态，部署时添加--no-cache参数强制刷新：

gcloud app deploy --no-cache

4. 临时调整distDir配置测试 #

你在next.config.js中指定了distDir: "build"，若build目录被误加入忽略规则或存在权限问题，可能间接引发构建异常。可临时注释该配置，使用默认的.next目录测试：

const nextConfig = {
    reactStrictMode: true,
    // distDir: "build",
};

module.exports = nextConfig;

若部署成功，再重新启用distDir配置，确保build目录未被.gcloudignore排除。

5. 确认命令执行的工作目录 #

确保执行npm run deploy时是在项目根目录下操作，避免因工作目录错误导致Next.js无法找到pages目录。

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