Python/Tweepy脚本调用OpenWeatherMap Tile API发布空白图片问题

核心问题 #

你的脚本仅通过response.raise_for_status()检查HTTP状态码，但OpenWeatherMap的地图瓦片API会在返回200状态码的情况下，将错误信息（如密钥无效、瓦片不存在）以JSON格式返回，导致你把错误JSON存成了.png文件，上传后自然显示空白。

具体解决步骤 #

1. 验证响应是否为有效图片 #

请求地图瓦片后，先检查响应的Content-Type是否属于图片类型，若不是则直接解析错误信息并终止流程：

import requests

map_url = "你的地图瓦片请求URL"
response = requests.get(map_url)
response.raise_for_status()

# 检查响应是否为图片格式
content_type = response.headers.get('Content-Type', '')
if not content_type.startswith('image/'):
    error_info = response.json()
    raise Exception(f"获取地图瓦片失败: {error_info['message']} (错误码: {error_info['cod']})")

# 保存有效图片文件
with open('weather_map.png', 'wb') as f:
    f.write(response.content)

2. 确认地图瓦片API的密钥权限 #

虽然你的密钥在天气数据接口可用，但地图瓦片服务可能需要单独开启权限，或者请求参数名不同（比如部分瓦片接口用api_key而非appid）。去OpenWeatherMap后台确认你的账户是否启用了地图服务，以及请求参数是否匹配官方要求。

3. 修正地图瓦片URL的生成逻辑 #

手动访问URL有时成功有时失败，说明你的URL参数（经纬度、缩放级别）可能偶尔超出有效范围，导致瓦片不存在。检查生成map_url的代码，确保：

• 经纬度在合法地理范围内
• 缩放级别（zoom）处于OpenWeatherMap支持的区间（通常为0-18）

4. 上传前验证图片完整性 #

调用Tweepy上传前，用PIL库检查文件是否为有效图片，避免上传无效文件：

from PIL import Image

try:
    with Image.open('weather_map.png') as img:
        img.verify()  # 验证图片格式完整性
except (IOError, SyntaxError):
    raise Exception("生成的图片文件无效，终止推文发布")

# 正常发布带图推文
api.update_status_with_media(status="你的天气文案内容", filename='weather_map.png')

内容的提问来源于stack exchange，提问作者Vinod Kumar Rodda