MySQL Shell for VS Code – 堡垒主机与检测到无效指纹
内容提要
MySQL Shell for VS Code是连接到OCI上的MySQL HeatWave DB实例的有用工具。如果遇到“检测到无效指纹”错误，可能是由于堡垒主机的密钥问题。解决此问题的方法是删除已存储在know_hosts文件中的堡垒主机的当前ssh主机密钥。完成后，您可以使用MySQL Shell for VS Code重新连接到MySQL HeatWave DB实例。
延伸解读
错误根源：堡垒主机密钥变更
文章指出，“检测到无效指纹”错误与用户OCI密钥的指纹无关，而是由于堡垒主机的SSH主机密钥发生了变化。当你更换堡垒主机或主机密钥被更新时，本地known_hosts文件中保存的旧密钥就会与新密钥不匹配，从而触发此错误。理解这一点有助于快速定位问题，避免误以为是自身密钥配置错误。
解决方法：清理known_hosts中的旧密钥
解决方法是使用ssh-keygen命令删除known_hosts文件中存储的堡垒主机当前SSH主机密钥。具体命令为：ssh-keygen -R "host.bastion.us-ashburn-1.oci.oraclecloud.com"，其中主机名需替换为你实际的堡垒主机地址。执行后，MySQL Shell for VS Code即可重新连接，无需其他额外操作。
适用场景与注意事项
此问题常见于堡垒主机发生变更后，例如主机重建、迁移或密钥轮换。如果你使用MySQL Shell for VS Code通过堡垒主机连接OCI上的MySQL HeatWave DB实例，并遇到类似错误，可优先检查known_hosts文件。注意，删除密钥后首次连接时，SSH客户端会提示确认新主机密钥，这是正常现象。
Q&A
MySQL Shell for VS Code 连接 MySQL HeatWave 时提示“检测到无效指纹”是什么原因？
该错误与用户 OCI 密钥的指纹无关，而是与堡垒主机的密钥有关。通常是因为堡垒主机发生了变化，导致本地存储的 SSH 主机密钥与当前堡垒主机不匹配。
如何解决 MySQL Shell for VS Code 的“检测到无效指纹”错误？
删除本地 known_hosts 文件中存储的堡垒主机的当前 SSH 主机密钥。使用命令：ssh-keygen -R "host.bastion.us-ashburn-1.oci.oraclecloud.com"，将主机名替换为你的堡垒主机地址。完成后即可重新连接。
MySQL Shell for VS Code 是什么工具？
MySQL Shell for VS Code 是一个用于连接 OCI 上 MySQL HeatWave DB 实例的工具，使用堡垒主机是连接的最简单方法。
使用 ssh-keygen -R 命令删除堡垒主机密钥后需要做什么？
删除后问题即已修复，你可以直接使用 MySQL Shell for Visual Studio Code 重新连接到 MySQL HeatWave DB 实例。
什么情况下会出现“检测到无效指纹”错误？
当你更改了堡垒主机时，可能会出现此问题，因为本地 known_hosts 文件中存储的旧主机密钥与新堡垒主机不匹配。
known_hosts 文件在解决此错误中起什么作用？
known_hosts 文件存储了堡垒主机的 SSH 主机密钥。当堡垒主机变更后，旧密钥会导致指纹验证失败，因此需要删除该文件中对应的旧密钥。
