vue-cli 4配置publicPath后生产环境出现Unexpected token '<'错误排查
问题成因
Uncaught SyntaxError: Unexpected token '<'这个报错和JS本身语法半毛钱关系没有。本质就是:浏览器按照HTML里的引用标签,去请求对应路径的JS/CSS静态资源时,没拿到预期的静态文件,反而拿到了SPA的index.html页面内容——HTML开头一般是<!DOCTYPE html>,第一个字符就是<,JS引擎把HTML当JS代码解析,碰到<这个根本不属于JS语法的字符时,直接抛出这个错误。
你配置publicPath: '/foo/'之后触发这个问题,核心就是前后端的路径配置完全没对齐,具体拆解下来就是这几个错位点:
- 前端构建阶段:设置
publicPath: '/foo/'后,构建产物里所有静态资源的引用路径,都会被改成基于/foo/前缀的绝对路径,比如原本引用的/js/app.xxxx.js,会被改成/foo/js/app.xxxx.js - 服务端部署阶段:没有对应调整服务端的路由映射规则,浏览器请求
/foo/js/app.xxxx.js时,因为服务端不存在这个路径的静态文件,直接命中了SPA的全路径兜底规则,返回了根目录下的index.html,最终触发解析错误 - 路由配置阶段:如果Vue Router用的是history模式,路由的base参数没有和publicPath保持对齐,会进一步放大路径错乱的问题,最终导致所有静态资源请求都返回HTML内容
修复方案
按顺序排查调整就行:
- 第一步:对齐服务端的路由映射规则
不管用Nginx、Apache还是第三方静态托管平台,所有匹配/foo/前缀的请求,都要正确指向实际存放构建产物的目录,同时把SPA的兜底入口改成/foo/index.html,而不是默认的根目录index.html。以Nginx为例,参考配置片段:server { location /foo/ { root /你的实际部署产物存放目录; # 找不到对应静态文件时,返回/foo路径下的index.html,不要指回根目录 try_files $uri $uri/ /foo/index.html; } } - 第二步:对齐前端路由的base配置
如果使用history模式的Vue Router,必须把路由实例的base参数设置成和publicPath完全一致的值,避免路由跳转时出现路径错配:const router = new VueRouter({ mode: 'history', base: '/foo/', routes: [] }) - 第三步:排查细节踩坑点
- 检查
publicPath的值有没有遗漏结尾的斜杠,比如写成/foo不带斜杠,构建时会把路径拼接成/foojs/app.xxxx.js,直接触发路径错乱 - 打开构建出来的dist目录下的index.html,确认里面的静态资源引用路径都正确带着
/foo/前缀,没有出现拼接错误 - 排查时直接打开浏览器网络面板,找到状态码200但被当JS解析失败的请求,看响应内容是不是index.html,顺着请求路径找服务端映射规则的问题就行,不需要上来就翻JS语法报错
- 检查
内容的提问来源于stack exchange,提问作者Beaumind
相关产品推荐
相关产品推荐

