部署在Google Cloud的Express/Angular5应用非根路由首次加载报NotFound
看起来你遇到的问题核心在于首次访问非根路由时,Service Worker尚未注册,而Express服务器的通配路由处理逻辑错误,导致返回404。当你先访问根路由后,Angular应用加载并注册了Service Worker,后续所有请求都会被Service Worker拦截并返回缓存的index.html,Angular路由就能正常接管了——这也是为什么每个浏览器只出现一次问题的原因。
下面是具体的修复步骤和代码调整:
1. 修复Express的通配路由处理
你的app.ts中通配路由使用了res.render('/public/index.html'),这是错误的:render方法是用于渲染模板引擎(比如你配置的Pug)的,而index.html是静态文件,应该用res.sendFile,并且路径需要正确拼接(不能用绝对路径/public/index.html,要基于当前文件的目录)。
修改app.ts中的通配路由代码:
// 替换原来的通配路由处理 app.get('*', (req, res) => { // 正确拼接index.html的路径,确保Express能找到文件 res.sendFile(path.join(__dirname, 'public', 'index.html')); });
为什么这能解决问题?
首次访问非根路由时,浏览器还没注册Service Worker,请求直接到达Express服务器。原来的res.render会尝试找Pug模板文件,但路径错误且index.html不是模板,所以触发404错误。修改为res.sendFile后,服务器会正确返回Angular的入口文件,应用加载后注册Service Worker,后续请求就会被Service Worker处理。
2. 验证Service Worker配置(ngsw-config.json)
你的ngsw-config.json配置是正确的,index: "/index.html"确保了Service Worker拦截所有路由请求时,都会返回缓存的index.html,让Angular路由处理页面跳转。不过可以再确认两点:
- 确保
assetGroups中的app组包含了index.html(你的配置已经包含) - 部署后检查Service Worker是否成功注册,可以在浏览器开发者工具的
Application > Service Workers中查看
3. 检查Google Cloud部署配置(可选)
如果你使用的是Google App Engine,确保app.yaml中的路由规则没有拦截非根路由,比如:
runtime: nodejs16 # 根据你的Node版本调整 handlers: - url: /api/* script: auto - url: /.* script: auto
这样所有非API请求都会转发到Express服务器,确保通配路由能生效。
测试验证
部署修改后的代码后,直接访问/login/signin:
- 服务器会正确返回
index.html - Angular应用加载并注册Service Worker
- 页面正常跳转到登录页面,不会出现404
后续再访问任何路由,都会由Service Worker拦截并返回缓存的index.html,Angular路由正常处理。
内容的提问来源于stack exchange,提问作者Michael Nelms

