location 读取的是当前页面自己的地址,本身不受同源策略限制;真正会卡住你的是“跨域去读别的窗口或接口”,而路径参数出问题,多半是编码没做、代理重写把前缀吃掉了。 下面按“先认清字段、再分清限制来源、最后给出可照抄的配置”这个顺序讲。
location 对象能读到什么:域名、端口、路径一次拆开
属性各管一段,别拿错
假设当前地址是 https://www.example.com:8080/user/123?tab=order#top:
| 属性 | 取到的值 | 说明 |
|---|---|---|
location.href |
完整地址 | 含协议、端口、参数、锚点 |
location.origin |
https://www.example.com:8080 |
协议+域名+端口,判断同源最稳 |
location.host |
www.example.com:8080 |
带端口 |
location.hostname |
www.example.com |
不带端口 |
location.pathname |
/user/123 |
路径部分 |
location.search |
?tab=order |
问号开头,没有参数时是空串 |
location.hash |
#top |
锚点,SPA 的 hash 路由参数在这里 |
host 和 hostname 混用是最常见的坑,做域名白名单校验时用 hostname,判断是否同源时用 origin,两者差一个端口就可能判错。
拿路径参数的标准写法
const params = new URLSearchParams(location.search);
const tab = params.get('tab'); // 不存在返回 null
const all = params.getAll('id'); // 同名多值
params.has('tab'); // 判断存在,比 !== null 更贴语义
老代码喜欢 search.slice(1).split('&') 再拆等号,遇到值里带编码过的 %26、%3D 就会切错。URLSearchParams 帮你处理了解码,省事也少 bug。
如果只需要解析任意 URL 而不只是当前页:
const u = new URL('https://api.example.com/v1/user/9?x=1');
u.hostname; u.pathname; u.searchParams.get('x');
new URL(relative, location.href) 还能把相对路径还原成绝对地址,做链接拼接很好用。
前端获取当前域名和路径参数时,跨域到底卡在哪
同源策略管的是“读别人的东西”
同源的三要素是协议、域名、端口,三者全等才算同源。location 读自己页面的地址栏信息,跟同源策略没关系,所以本地 localhost:5173 上随便读 location.hostname 都没问题,会被拦的是下面这些:
- 用
iframe.contentWindow.location.href读另一个源的页面地址,浏览器直接抛SecurityError fetch/XMLHttpRequest跨域请求,没拿到 CORS 响应头就读不到响应体- 跨域图片画进 canvas 后调用
getImageData会被污染
三种真实场景
- iframe 嵌子域名页面:父页面想拿子页面的 URL 和参数,直接读属性行不通,只能让子页面自己上报
- 本地开发调后端:页面在 5173 端口,接口在 8080,端口不同即跨域
- 主域与 api 子域共享登录态:
www.example.com调api.example.com,域名不同,带 Cookie 时限制更多
另外提醒一句,0.0.1 和 localhost 在浏览器眼里是两个不同的主机名,Cookie 和 CORS 白名单都要分别配置。
location.href获取域名跨域报错怎么解决?四种方案按场景挑
服务端补 CORS 响应头(接口跨域首选)
关键几点,少一个都不行:
Access-Control-Allow-Origin写具体域名,不要写- 需要携带 Cookie 时,必须配合
Access-Control-Allow-Credentials: true,Allow-Origin不能是通配符 - 前端
fetch要加credentials: 'include' - 非简单请求会先发
OPTIONS预检,服务端要正常返回 204,并带上Allow-Methods、Allow-Headers Access-Control-Max-Age可以缓存预检结果,减少往返
按 Fetch 标准的定义,只要响应头不满足条件,浏览器就会在 JS 层把响应“藏起来”,控制台报错但请求其实已经发出去了这也是很多人误以为“后端没收到”的原因。
开发环境走代理(本地调试首选)
Vite 的写法:
server: {
proxy: {
'/api': {
target: 'http://localhost:8080',
changeOrigin: true,
rewrite: p => p.replace(/^\/api/, '')
}
}
}
Webpack devServer 用 devServer.proxy,字段名基本对应。changeOrigin: true 改的是请求头里的 Host,后端如果按 Host 做校验或做多租户路由,这一项必须开,否则容易 403。
postMessage 跨窗口传地址
父页面读不到跨域 iframe 的 location,那就反过来让子页面主动说:
// 子页面
parent.postMessage({ url: location.href }, 'https://parent.example.com');
// 父页面
window.addEventListener('message', e => {
if (e.origin !== 'https://child.example.com') return;
const data = new URL(e.data.url);
data.searchParams.get('id');
});
必须校验 e.origin,否则任何页面都能往你的窗口塞消息,至于 document.domain,主流浏览器近年来已逐步弱化并弃用这一机制,新项目不要再依赖它做跨子域通信。
Nginx 反向代理(生产环境首选)
location /api/ {
proxy_pass http://backend:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
proxy_pass 末尾那个斜杠是有语义的:带 会把匹配到的 /api/ 前缀替换掉,不带则原样透传。路径参数丢失的高发点就在这一个字符上。 行业共识认为,生产环境用同源反向代理,比放开一堆 CORS 白名单更省心,暴露面也更小。
跨域请求时如何携带路径参数:三种传参方式怎么选
query、path、body 的分工
- query 参数
/list?id=1&type=2:适合筛选、分页、可分享的链接,能被缓存和日志完整记录 - path 参数
/user/123/order:适合标识资源本身,语义清晰,RESTful 风格常用 - body:适合大数据量和敏感字段,GET 请求不能带
跨域场景下,参数写在 URL 里就意味着它会经过代理、网关、Nginx 每一层,任何一层的路径重写都可能让它对不上后端路由,最终表现为 404 或参数为空。
编码这一步不能省
规则很简单:编码参数值,不要编码整个 URL。
const qs = new URLSearchParams({ keyword: 'a&b#c', page: 2 }).toString();
// keyword=a%26b%23c&page=2
不编码的后果很直接:值里的 & 会被当成分隔符切成两个参数, 之后的内容会被整段识别成锚点,服务端根本收不到。URLSearchParams 还有个细节空格会被编码成 而不是 %20,后端解析库如果不兼容加号形式,需要手动替换。
参数丢了,按这个顺序排查
- 浏览器 Network 面板看实际请求的完整 URL,确认参数是否发出
- 对照 proxy 的
rewrite规则,看前缀替换是否符合预期 - 看后端 access log 里的 path,确认到达时是什么样
- 检查 Nginx
proxy_pass有没有多余的尾斜杠 - 确认后端路由用的是
@RequestParam还是@PathVariable,两者取的段不一样
本地开发环境跨域获取域名参数配置
本地调接口时,建议统一走相对路径 /api/xxx,由代理转发,不要在前端代码里硬写 http://localhost:8080,否则上线前要改一遍,Cookie 在 localhost 下的 SameSite 属性各家浏览器处理略有差异,涉及登录态联调时,优先把前后端都挂到同一个域名下的不同路径,用代理打通,比反复调 CORS 头省时间。
几个容易忽略的细节
location.href = url会新增历史记录,location.replace(url)不会,做登录跳转时按需选- hash 路由项目里,
#/user?id=1的参数在location.hash里,location.search是空的,别找错地方 - 服务端渲染环境没有
location全局对象,要改用请求对象上的地址信息 - 路径参数里带中文务必编码,部分服务器会直接返回 400
location属性是只读的,但给href、hash赋值会触发跳转,这是它特殊的地方
Q&A:location获取域名与跨域路径参数常见问题
Q1:location.origin 和 location.host 判断跨域该用哪个?
用 origin,它包含协议、域名、端口三要素,正好对应同源策略的判定标准;host 只有域名加端口,丢了协议,http 和 https 混用时容易误判为同源,业内专家指出,前端做域名白名单、跳转校验时,统一以 origin 为准,可以减少一类配置不一致的线上问题。
Q2:跨域 iframe 里怎么拿到子页面的路径参数?
父页面无法直接读子页面的 location,正确做法是子页面在加载完成后,用 postMessage 把自己的 location.href 发给父页面,父页面校验 origin 后,再用 new URL() 解析出 searchParams,如果子页面不可控,就只能通过约定好的 URL 参数由父页面自己拼出来。
Q3:代理配好了,接口还是 404 或参数为空,通常是什么原因?
按概率排,第一位是 proxy_pass 或 rewrite 的前缀替换与后端路由不匹配,第二位是参数值没做 encodeURIComponent 导致 截断,第三位是预检请求被网关拦截只放行了 GET,逐一在 Network 面板和网关日志里对照,基本都能定位到具体某一层,据 MDN 对 Location 接口的字段定义,search 始终以 开头且不含 之后的内容,理解这一点能排除不少“参数凭空消失”的误判。
跨域与路径参数这两个问题,本质上一个在“谁能读谁”,一个在“字符串怎么传”,把 origin 判同源、把参数交给 URLSearchParams、把转发交给同源代理,三条守住,绝大多数 location 相关的报错都不会再出现。