前言

在前端开发、自动化测试、定位类应用调试、WebRTC LBS 场景验证中，修改浏览器的定位信息是一项非常常见的需求。Chromium/Chrome 作为主流浏览器，提供了多种官方或半官方的方式来模拟地理位置。本文将从开发者视角，系统讲解五种可行方法，从 DevTools 到 CDP、扩展、系统级模拟到 JS 注入，适合工程师在各种环境中使用。

一、为什么需要修改浏览器 GPS 定位？

常见场景包括：
• Web LBS 应用的前端调试
• Google Maps / 高德 / 百度地图测试
• WebRTC 基于位置的服务
• UI 自动化（Selenium / Puppeteer）需要模拟真实地理位置
• 地图产品验证定位偏差
• 企业内部测试不同区域的访问行为
修改浏览器定位并不是为了绕过限制，而是为了开发调试便利。

二、最推荐的方法：Chrome DevTools Sensors 修改定位

1. 打开 Sensors 面板

步骤如下：
① 打开浏览器 → 按 F12 打开开发者工具
② 按 Ctrl + Shift + P（Command Palette）
③ 输入 “sensors” 并选择 “Show Sensors”
④ 在底部找到 Geolocation

你可以选择内置定位（Berlin、Tokyo、San Francisco 等），也可以选择自定义坐标。

2. 自定义经纬度

Latitude: 22.543096
Longitude: 114.057865
Accuracy: 1

刷新页面即可看到基于新定位的效果。Chrome 内置的定位模拟完全遵循 W3C Geolocation API 标准，适用于所有基于 JS 的定位场景。

三、通过 Chrome DevTools Protocol（CDP）程序化修改定位（Puppeteer / Selenium）

如果你需要在 CI、自动化测试中批量修改定位，DevTools Protocol 是最专业、最稳定的方法。

1. Puppeteer 示例

const browser = await puppeteer.launch({ headless: false });
const page = await browser.newPage();

await page.setGeolocation({ latitude: 22.543096, longitude: 114.057865 });

await page.goto('https://www.google.com/maps');

Puppeteer 实际上使用的是 Chrome 官方的 CDP 接口，因此兼容性最高。

2. Selenium + Chrome 示例

ChromeOptions options = new ChromeOptions();
Map<String, Object> coords = new HashMap<>();
coords.put("latitude", 22.543096);
coords.put("longitude", 114.057865);
coords.put("accuracy", 1);

Map<String, Object> params = new HashMap<>();
params.put("geoLocation", coords);

WebDriver driver = new ChromeDriver(options);
((ChromeDriver) driver).executeCdpCommand("Emulation.setGeolocationOverride", params);

在自动化测试中是最常用的做法，可精确控制经纬度。

四、使用 Chrome 插件模拟定位（低代码方式）

如果你不想打开 DevTools，也不想写代码，可以使用定位模拟插件，例如：
• Location Guard
• Fake Geolocation
• Virtual Location

这些扩展能持久化自定义定位，适合非开发者使用，但某些网站可能检测得到。

五、系统级 GPS 修改（Android / Windows / Linux）

1. Android（Chrome Mobile）

Android 原生支持模拟位置：
① 开发者选项 → 选择模拟位置应用
② 配合 Fake GPS / GPS Joystick 等 APP
Chrome Mobile 会直接使用模拟 GPS 数据。

2. Windows / Linux

这类系统没有统一的系统定位 API，因此 Chromium 使用网络定位或 IP 位置，但你仍可以：
• 通过驱动安装虚拟 GPS
• 使用 NMEA 虚拟串口模拟设备
这些属于企业测试用途，配置复杂，不适合普通开发者。

六、JS 注入重写 Geolocation API（仅用于开发环境）

这是一种“软替换”方式，通过前端脚本直接覆盖浏览器定位。

navigator.geolocation.getCurrentPosition = function(success) {
  success({
    coords: {
      latitude: 22.543096,
      longitude: 114.057865,
      accuracy: 1
    }
  });
};

适用于：
• 内部平台
• 本地调试
• CI 临时覆盖
但无法模拟 watchPosition，也无法通过更底层 API 访问。

七、浏览器定位使用优先级顺序（重要）

Chromium 实际定位优先级如下：
1. DevTools Sensors（最高优先级）
2. CDP 定位注入
3. 系统级 GPS（移动端）
4. 网络定位（WiFi/IP + Google Location Service）
5. 默认位置（无权限时）

这能解释为什么 DevTools 一旦开启模拟坐标，会覆盖一切定位方式。

八、常见问题（FAQ）

1. 为什么我设置了定位但网站显示“定位失败”？

原因通常包括：
• 网站检测到 DevTools 开启（某些平台会阻断）
• HTTPS 才能使用地理定位
• 浏览器被系统隐私设置阻止定位访问

2. 为什么 Chrome Mobile 位置总是跳回真实 GPS？

因为 Android 系统定位优先级高于浏览器，你需要使用“模拟位置应用”。

3. 为什么 JS 注入不起作用？

因为：
• 某些网站使用 HTTPS Secure Context
• 浏览器启用了高级安全保护
• WebAssembly 或 Native SDK 绕过了 JS

在测试、开发、自动化环境中，修改 Chromium/Chrome 的 GPS 定位非常常见。DevTools Sensors 是最简单的方法，CDP 最适合自动化，而移动端则可以依赖系统级模拟工具。本文提供的五个方式几乎覆盖所有开发使用场景，可以作为你今后调试定位类业务的参考文档。