Grafana连接InfluxDB Cloud测试成功但InfluxQL查询报数据库不存在

数据源创建时的连通性校验仅验证网络可达、API Token认证通过，不会对配置的database字段做存在性校验——这就是连通性提示正常、实际查询直接报错的根本原因，按以下步骤逐项排查即可解决：

• 核对存储单元映射关系
  InfluxDB 2.x及以上的免费云实例，没有传统1.x版本的原生database概念，查询时系统会把Grafana数据源里填写的database字段值，和当前Token权限下能访问的bucket名称做一一匹配。只要名称和实际bucket名有差异（大小写不一致、漏了实例自动追加的组织ID后缀、多了空格），就会直接抛出Database not found错误。
  操作时直接登InfluxDB控制台复制目标bucket的完整名称，1:1粘贴到Grafana数据源的Database输入框，不要手动简化或修改字符。
• 检查查询语言配置
  如果你计划用InfluxQL复用类似TSQL的查询习惯，必须在数据源配置的「Language」选项中明确选择InfluxQL，而不是默认的Flux。如果选了Flux，系统会跳过database字段的映射逻辑，直接请求Flux查询接口，触发找不到库的报错。
• 排除API Token权限问题
  不要使用全局只读Token配置连接：这类Token虽然能通过连通性校验，但默认不具备读取bucket元数据的权限，会导致系统识别不到关联的存储单元。需要把Token替换为和目标bucket绑定、具备数据读权限的专用Token，不要使用跨实例的只读默认Token。
• 检查兼容模式开关
  免费版InfluxDB Cloud 3.x默认不开启InfluxQL兼容访问端点，如果手动没打开这个开关，哪怕配置完全正确，查询请求也会因为路由不匹配抛出同类错误。需要在InfluxDB实例的设置页手动启用InfluxQL兼容接口，才能正常走InfluxQL查询逻辑。
• 清除缓存残留
  多次重建、修改数据源配置后，记得在面板查询页手动刷新一次数据源选择列表，清掉浏览器端缓存的旧配置值——很多时候后台已经改对了库名，前端还在传之前填错的旧值，导致报错反复出现。

注意：免费版InfluxDB Cloud对InfluxQL的支持是兼容层实现，不是原生适配，复杂聚合查询语法可能和传统1.x InfluxDB有细微差异。查询时可以先从最简单的SELECT * FROM <bucket名> LIMIT 10开始验证连通性，确认链路通了再写复杂查询。

内容的提问来源于stack exchange，提问作者singhswat