本文详解如何使用浏览器 Geolocation API 获取用户经纬度，并通过 Fetch API 安全、准确地提交至 Express 服务器，避免因对象结构不匹配导致的 Cannot read properties of undefined (reading 'loc') 错误。
本文详解如何使用浏览器 geolocation api 获取用户经纬度，并通过 fetch api 安全、准确地提交至 express 服务器，避免因对象结构不匹配导致的 `cannot read properties of undefined (reading 'loc')` 错误。
在 Web 开发中，将客户端获取的地理位置（如经纬度）传递给后端是常见需求（例如天气查询、附近服务等）。但初学者常因前后端数据结构不一致而报错——正如问题中所示：前端构造了 {latitude: ..., longitude: ...} 对象并直接发送，而后端却尝试访问 req.body.loc，而实际请求体中根本不存在 loc 这一嵌套字段。
✅ 正确做法是：前后端保持数据结构一致，避免无谓嵌套。前端应直接发送扁平化的坐标对象；后端则直接解构 req.body，而非假定其包裹在 loc 属性下。
以下是完整、健壮的实现方案：
✅ 前端（HTML/JS）：增强错误处理与响应解析
<script>
if ("geolocation" in navigator) {
navigator.geolocation.getCurrentPosition(
async (position) => {
const { latitude, longitude } = position.coords;
const locationData = { latitude, longitude };
console.log("? 用户位置：", locationData);
try {
const response = await fetch("/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(locationData), // 直接发送 {latitude, longitude}
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${response.statusText}`);
}
const result = await response.json();
console.log("✅ 服务器响应：", result);
} catch (err) {
console.error("❌ 位置上传失败：", err);
}
},
(error) => {
console.error("⚠️ 获取位置失败：", error.message);
document.getElementById("location-display").textContent =
"无法获取您的位置：" + error.message;
}
);
} else {
document.getElementById("location-display").textContent =
"您的浏览器不支持地理定位功能。";
}
</script>✅ 后端（Express）：正确解析并响应
const express = require("express");
const app = express();
// 必须启用 JSON 解析中间件（顺序重要）
app.use(express.json());
app.use(express.urlencoded({ extended: true })); // 兼容表单等其他场景
app.get("/", (req, res) => {
res.sendFile(__dirname + "/index.html");
});
app.post("/", (req, res) => {
// ✅ 直接解构 req.body —— 因为前端发送的是 {latitude, longitude}
const { latitude, longitude } = req.body;
// 验证必要字段（生产环境强烈建议）
if (typeof latitude !== "number" || typeof longitude !== "number") {
return res.status(400).json({ error: "无效的经纬度数据" });
}
console.log("? 收到位置数据：", { latitude, longitude });
// 示例：后续可接入天气 API 等逻辑
res.json({
message: "位置接收成功",
location: { latitude, longitude },
timestamp: new Date().toISOString(),
});
});
app.listen(5000, () => {
console.log("? 服务器运行于 http://localhost:5000");
});⚠️ 关键注意事项：
- 不要嵌套 loc 字段：前端 JSON.stringify(loc) 中的 loc 是 JS 变量名，不会自动成为 JSON 的 key；它只是对象字面量 {latitude, longitude} 的别名。因此后端 req.body.loc 必然为 undefined。
- 始终校验输入：地理坐标应为数字类型，需在服务端做基础验证，防止恶意或异常数据。
- 启用 express.urlencoded()：虽本例用 JSON，但添加该中间件可提升应用鲁棒性（兼容未来可能的表单提交）。
- 处理异步错误：前端使用 try/catch 捕获网络异常、权限拒绝等，提升用户体验。
- CORS 注意事项：若前端与后端域名/端口不同，需在 Express 中配置 cors 中间件（本例同源可忽略）。
通过以上调整，即可稳定、安全地将用户地理位置传递至服务端，为后续天气查询、地图渲染等业务打下坚实基础。
立即学习“前端免费学习笔记（深入）”；
