本地启动Spring Boot应用遇InetUtils主机名识别失败及GCP认证警告

一、修复「Cannot determine local hostname」错误 #

该错误源于Spring Cloud的InetUtils组件无法解析本地主机名，可通过以下方式解决：

• 修改hosts文件：在本地hosts文件中添加主机名映射。Windows路径为C:\Windows\System32\drivers\etc\hosts，Linux/macOS路径为/etc/hosts，添加内容（替换your-local-hostname为实际主机名，可通过hostname命令查看）：

  127.0.0.1   your-local-hostname
  ::1         your-local-hostname
  

• 配置Spring Cloud参数：在application.properties或application.yml中强制指定主机名和优先网络：
  properties格式：

  spring.cloud.inetutils.preferred-networks=127.0.0.1
  spring.cloud.inetutils.hostname=localhost
  

  yml格式：

  spring:
    cloud:
      inetutils:
        preferred-networks: 127.0.0.1
        hostname: localhost
  

• 启动时指定JVM参数：执行启动命令时添加参数强制指定主机名：

  mvn spring-boot:run -Dspring.cloud.inetutils.hostname=localhost
  

二、排查GCP认证警告 #

结合主机名问题，先修复前者再验证认证警告，若警告仍存在，按以下步骤排查：

• 确认凭证文件路径：检查application_default_credentials.json是否在默认路径：
  • Windows: %APPDATA%\gcloud\application_default_credentials.json
  • Linux/macOS: ~/.config/gcloud/application_default_credentials.json
    确保文件存在且当前用户拥有可读权限。
• 显式指定凭证路径：在Spring Boot配置中明确指定凭证文件位置，避免自动加载失败：
  properties格式：

  spring.cloud.gcp.credentials.location=file:${user.home}/.config/gcloud/application_default_credentials.json
  

  yml格式：

  spring:
    cloud:
      gcp:
        credentials:
          location: file:${user.home}/.config/gcloud/application_default_credentials.json
  

• 验证凭证有效性：执行gcloud auth application-default print-access-token，若能输出有效token，说明凭证本身无问题，需排查应用端加载逻辑。

三、验证错误关联 #

先解决主机名错误后重启应用：

• 若认证警告消失，说明两者存在关联——InetUtils的异常干扰了GCP客户端的初始化流程；
• 若警告仍存在，可单独聚焦GCP认证配置，检查是否有其他依赖或配置冲突。

内容的提问来源于stack exchange，提问作者Henry Xiloj Herrera