You need to enable JavaScript to run this app. SvelteKit部署至Google Cloud Run绑自定义域名时[slug]路由资源加载失败
优惠活动
大模型
产品
解决方案
定价
更多

SvelteKit部署至Google Cloud Run绑自定义域名时[slug]路由资源加载失败

SvelteKit 绑定Cloud Run自定义域名后动态路由资源404解决方案

问题根因

  • Cloud Run默认分配的*.run.app域名边缘代理对URL特殊字符兼容度高,请求可直接透传到后端Node服务
  • 绑定自定义域名后,请求会先经过Google域名网关的前置路径校验,URL路径中未做百分号编码的[、]属于RFC定义的路径保留字符,会被网关判定为非法请求直接拦截返回404,不会转发到后端服务
  • 报错中实际请求的静态资源路径/_app/pages/planes/[slug].svelte-098e0796.js直接将动态路由的方括号标识写入了资源文件名,未做转义替换,就是导致自定义域名下请求被拦截的直接原因

具体修复步骤

  • 调整Vite构建的资源命名规则,移除输出文件名中的方括号特殊字符
    在svelte.config.js的kit.vite配置块下新增rollup输出自定义规则,替换动态路由生成的chunk、资源文件中的[、]字符,避免生成带特殊字符的资源路径:
    vite: {
        // 原有ssr配置保留
        build: {
            rollupOptions: {
                output: {
                    chunkFileNames: (chunkInfo) => {
                        const safeName = chunkInfo.name.replace(/[\[\]]/g, '')
                        return `_app/pages/${safeName}-[hash].js`
                    },
                    assetFileNames: (assetInfo) => {
                        const safeName = assetInfo.name.replace(/[\[\]]/g, '')
                        return `_app/assets/${safeName}-[hash][extname]`
                    }
                }
            }
        },
        ssr: {
            noExternal: Object.keys(pkg.dependencies || {})
        }
    }
    
  • 显式声明静态资源基础路径,避免运行时host推导出现偏差
    在kit配置块下补充paths配置,不依赖自动的host路径推导:
    kit: {
        // 原有hostHeader、adapter等配置全部保留
        paths: {
            base: ''
        },
        hostHeader: 'X-Forwarded-Host',
        adapter: node(),
        // 其他原有配置保持不变
    }
    
  • 修正Dockerfile的构建流程,避免本地构建和容器运行时的路径不匹配
    原Dockerfile直接COPY本地构建的build目录,容易出现资源路径与容器内运行环境不匹配的问题,替换为在容器内完成全流程构建的配置,同时升级已停止维护的Node12基础镜像:
    FROM node:18-alpine
    WORKDIR /youernes
    ENV PORT=8080
    ENV HOST=0.0.0.0
    COPY . .
    # 容器内执行依赖安装与项目构建,保证路径一致性
    RUN npm ci && npm run build
    CMD [ "node" , "build/index.js" ]
    
  • 补充路径兜底处理
    在src/hooks.js中新增请求路径处理逻辑,对已做百分号编码的方括号路径做兜底兼容:
    export async function handle({ event, resolve }) {
        const originalPath = event.url.pathname
        // 兼容历史缓存中已生成的带编码方括号的资源请求
        if (originalPath.includes('%5B') || originalPath.includes('%5D')) {
            event.url.pathname = originalPath.replace(/%5B/g, '').replace(/%5D/g, '')
        }
        return resolve(event)
    }
    

验证方式

重新构建镜像部署到Cloud Run后,打开自定义域名下的动态路由页面,检查Network面板的静态资源请求,确认资源URL中不存在未编码的[、]字符,所有_app路径下的资源请求均返回200状态,页面可正常完成水合渲染。

内容的提问来源于stack exchange,提问作者Angel Serrano Perez

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.27 12:27:05