使用CDK部署AWS Amplify Next.js SSR应用无法识别为SSR的问题咨询

问题原因
该问题是CDK v1版本的@aws-cdk/aws-amplify包默认未配置Next.js SSR所需的平台标识导致的:
- 手动通过AWS控制台部署时,控制台会自动扫描仓库代码,识别到Next.js框架后自动将分支的
platform属性设置为WEB_COMPUTE(SSR专用运行平台),因此可以正常识别为SSR应用。 - 通过CDK部署时,v1版本的Amplify构造没有主动扫描仓库判断框架的逻辑,也未暴露直接设置platform的高层API,默认使用静态站点的平台配置,因此不会显示框架标识,也无法正常运行SSR能力。
另外你当前配置中添加的重定向规则是Next.js SSG静态站点专用的规则,会拦截所有动态路由请求重写到index.html,反而会破坏SSR的路由逻辑,需要移除。
修复方案
1. 移除冗余的SSG重定向规则
删除代码中amplifyApp.addCustomRule的相关配置,Next.js SSR的路由由Amplify托管平台自动处理,不需要手动配置这条重定向。
2. 显式给分支设置SSR运行平台
通过CDK的CFN逃逸层配置,给部署分支显式设置WEB_COMPUTE平台属性,修改后的代码示例如下:
import * as cdk from '@aws-cdk/core'; import * as amplify from '@aws-cdk/aws-amplify'; import codebuild = require('@aws-cdk/aws-codebuild'); export class AmplifyStack extends cdk.Stack { constructor(scope: cdk.Construct, id: string, props: cdk.StackProps) { super(scope, id, props); const sourceCodeProvider = new amplify.GitHubSourceCodeProvider({ owner: '.....', repository: '....', oauthToken: cdk.SecretValue.secretsManager('github-token'), }); const buildSpec = codebuild.BuildSpec.fromObjectToYaml( { version: 1, applications: [ { frontend: { phases: { preBuild: { commands: [ "npm install" ] }, build: { commands: [ "npm run build" ] } }, artifacts: { baseDirectory: ".next", files: [ "**/*" ] }, cache: { paths: [ "node_modules/**/*" ] } } } ] } ); const amplifyApp = new amplify.App(this, "cdk-nf-web-app", { sourceCodeProvider: sourceCodeProvider, buildSpec: buildSpec }); const developBranch = amplifyApp.addBranch('develop', { basicAuth: amplify.BasicAuth.fromGeneratedPassword('dev') }); // 核心修改:通过CFN层设置SSR专用平台 const cfnBranch = developBranch.node.defaultChild as amplify.CfnBranch; cfnBranch.platform = 'WEB_COMPUTE'; // 可选:如果使用12版本以下的Next.js,添加SSR开启环境变量 amplifyApp.addEnvironment('AMPLIFY_NEXTJS_EXPERIMENTAL_SSR_ENABLED', 'true'); } }
3. 验证配置
部署修改后的CDK堆栈,重新触发Amplify构建,构建完成后即可在控制台看到Next.js框架标识,SSR功能也会正常运行。
内容的提问来源于stack exchange,提问作者Panos Karampis
相关产品推荐
相关产品推荐

