Django集成Google地图失败原因及解决方法

在Django中动态嵌入Google地图时，URL通过模板变量（如`{{ maps_link }}`）传入后页面被浏览器阻止显示，根本原因并非跨域或iframe限制，而是Django默认的HTML转义机制将已存储的`&`实体原样输出为字面字符，导致URL中出现非法的`&`而非正确的`&`，从而被Google Maps服务器拒绝；解决方案是在视图层对URL字符串显式执行`.replace('&', '&')`，确保传入模板的是语法合规的纯URL——这一简单修复能让动态渲染与硬编码行为完全一致，彻底解决“同一URL、不同表现”的困惑。

当在Django模板中将Google Maps嵌入URL通过上下文变量（如`{{ maps_link }}`）传入`

在Django模板中，& 是HTML转义序列，用于在HTML文档中安全地表示 & 字符（避免与URL参数分隔符混淆）。当URL被硬编码在HTML中时，浏览器在解析HTML时会自动将 & 解码为 &，最终向Google Maps发起的请求是合法的：

<!-- 硬编码示例：浏览器自动解码 &amp; → & -->
<iframe src="https://maps.google.com/maps?q=-28.4457436,21.268374&hl=en&z=14&amp;output=embed"></iframe>
<!-- 实际加载的URL为： -->
<!-- https://maps.google.com/maps?q=-28.4457436,21.268374&hl=en&z=14&output=embed -->

但当URL作为Python字符串通过context传入模板（例如 {{ maps_link }}），Django默认会对变量内容进行HTML转义（防止XSS攻击）。若原始字符串已包含&（如数据库中存储的是HTML-safe形式），Django不会再次解码它——而是原样输出为字面量 &，导致