You need to enable JavaScript to run this app. 使用CDK部署AWS Amplify Next.js SSR应用无法识别为SSR的问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 02:57:03