curl -s 'https://maps.googleapis.com/maps/api/js?key=KEY&callback=init' | head # 查看控制台是否有 referer 受限报错
页脚嵌入的地图上浮着一层半透明提示「for development only」,控制台报 This page didn't load Google Maps correctly。这类现象通常不是突然出现的,往前翻半天日志能看到苗头。
追下去是这么回事:地图 API 密钥没有启用计费,也没有配置 HTTP referrer 白名单,请求被判定为开发用途。域名换过之后白名单还是旧域名。
围绕「页脚地图密钥未授权」排查时,命令行跑一遍比在面板里点十次有用,面板会替你做掉不少隐式操作。权限不要一口气开到最大,先加到够用再往上试,范围小才好收。
把复现步骤压到三条以内,交给同事也能跑出来,才算真的定位清楚。改动写完就同步给同事,下一个人踩同一个坑,成本还是你的。
验证用真实数据走一遍,测试数据太干净,边界情况根本碰不到。
处理上按这个顺序:在控制台给密钥绑定当前域名,通配符别写成星号;确认计费账号有效,否则地图长期带水印;换域名时把地图白名单列进上线清单。
确认没问题再收工,页脚地图正常加载,水印提示消失,控制台无密钥报错。
