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
相关产品推荐
相关产品推荐

