配置Google Logback LoggingAppender输出到STDOUT时遇项目ID必填错误

问题根源 #

尽管配置了redirectToStdout=true让日志输出到标准输出，但LoggingAppender的初始化逻辑仍会尝试完成Google Cloud日志客户端的基础配置，这一步强制要求提供项目ID——哪怕最终不会实际调用Google Logging API。文档中提到的“无需设置项目ID”仅适用于Google Cloud平台内部环境，此时项目ID会自动从环境变量中读取，本地调试时没有这个环境变量，因此触发错误。

快速解决办法 #

你可以通过以下两种方式绕过项目ID检查：

1. 临时设置环境变量
   本地启动应用前，设置环境变量GOOGLE_CLOUD_PROJECT为任意格式合法的字符串（比如my-local-test-project），不需要是真实存在的Google Cloud项目。

2. 在logback.xml中配置占位符项目ID
   直接在LoggingAppender中添加projectId配置项，填一个虚拟的项目ID即可：

   <appender name="CONSOLE" class="com.google.cloud.logging.logback.LoggingAppender">
       <redirectToStdout>true</redirectToStdout>
       <projectId>my-local-test-project</projectId>
   </appender>
   <root>
       <level value="info" />
       <appender-ref ref="CONSOLE" />
   </root>
   

   配置后，LoggingAppender会完成初始化并进入标准输出模式，不会实际连接Google Logging API。

更优雅的本地测试方案 #

如果不想处理Google客户端的初始化逻辑，建议通过Logback的条件配置，在本地调试时使用原生的ConsoleAppender，生产环境再切换为LoggingAppender：

<!-- 本地调试用原生ConsoleAppender -->
<appender name="LOCAL_CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>

<!-- 生产环境用Google LoggingAppender -->
<appender name="GCP_LOGGING" class="com.google.cloud.logging.logback.LoggingAppender">
    <!-- 生产环境配置，比如logDestinationProjectId等 -->
</appender>

<!-- 根据环境变量切换appender -->
<root level="info">
    <if condition='property("app.env").equals("local")'>
        <then>
            <appender-ref ref="LOCAL_CONSOLE" />
        </then>
        <else>
            <appender-ref ref="GCP_LOGGING" />
        </else>
    </if>
</root>

启动本地应用时，通过-Dapp.env=local参数触发原生ConsoleAppender，既能测试日志格式，又避免了Google客户端的配置问题。

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