GitHub Action调试模式下从配置字典获取的Token为何被截断？

问题概述 #

在GitHub Action中运行Python脚本时出现异常：仅启用调试模式（设置DEBUG=1并传入--debug参数）时，从环境变量读取的GITHUB_TOKEN存入配置字典后会被截断，导致GitHub API认证失败（返回401错误）。

上下文信息 #

• Python脚本main.py作为GitHub Actions工作流的执行环节
• 工作流通过环境变量GITHUB_TOKEN传入secrets.GITHUB_TOKEN
• config.py模块使用os.environ.get()读取环境变量并写入配置字典
• main.py调用config.load_config()获取字典，用其中的Token初始化GitHub API客户端
• 各环节已添加调试日志用于问题排查

相关代码片段 #

工作流配置（.github/workflows/...yml） #

jobs:
  analyze-milestones:
    runs-on: ubuntu-latest
    steps:
      # ... 省略checkout、setup python步骤 ...
      - name: Run Milestone Assistant
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          # OPENROUTER_API_KEY: ...
          DEBUG: ${{ github.event.inputs.debug_mode == 'true' && '1' || '0' }} # 调试标志
        run: |
          cd tools/milestone-assistant
          python -m src.main \
            # ... 其他参数 ...
            ${{ github.event.inputs.debug_mode == 'true' && '--debug' || '' }}

配置加载模块（src/config.py） #

import os
import logging

logger = logging.getLogger(__name__)
DEFAULT_CONFIG = { "github": { "token": "", ... }, ... }

def load_config():
    config = DEFAULT_CONFIG.copy()
    github_token_env = os.environ.get("GITHUB_TOKEN")
    if github_token_env:
        config["github"]["token"] = github_token_env
        # 读取后立即记录日志
        logger.debug(f"Read token from GITHUB_TOKEN. Type: {type(github_token_env)}, Length: {len(github_token_env)}")
    # ... 加载其他配置 ...
    return config

主脚本（src/main.py） #

import argparse
import logging
import os
from .config import load_config
from .github.client import GitHubClient

logger = logging.getLogger(__name__)

def main():
    args = parse_args() # 解析--debug参数
    setup_logging(logging.DEBUG if args.debug else logging.INFO)

    config = load_config()
    config_token = config["github"]["token"]

    # 记录从字典获取的Token长度
    logger.debug(f"Initializing GitHub client with token length: {len(config_token)}")

    # 初始化客户端（Token过短时会触发401失败）
    github_client = GitHubClient(
        token=config_token,
        repository=config["github"]["repository"]
    )
    # ... 脚本剩余逻辑 ...

if __name__ == "__main__":
    main()

问题现象 #

启用调试模式时，日志输出如下：

# 在config.py的load_config()中
DEBUG - Read token from GITHUB_TOKEN. Type: <class 'str'>, Length: 40

# 在main.py中，调用load_config()之后
DEBUG - Initializing GitHub client with token length: 14 # <-- Token被截断！

# 在github/client.py初始化时
DEBUG - Initializing GitHub client with token length: 14

# API调用结果
ERROR - API access test failed: 401
ERROR - Authentication failed. Please check your GitHub token.

临时解决方案 #

在main.py中添加检查逻辑：若config["github"]["token"]长度小于40，则直接重新读取os.environ.get("GITHUB_TOKEN")，该方案可正常绕开问题。

根本原因分析 #

最可能的核心原因是调试模式触发了后续配置逻辑覆盖Token值：

1. load_config()中先从环境变量读取并设置了正确的40位Token
2. 在后续的# ... load other config ...代码段中，存在调试模式专属的配置加载逻辑（比如读取本地调试配置文件、加载调试专用参数），这部分逻辑将config["github"]["token"]覆盖成了长度为14的无效值
3. 仅在调试模式开启时该覆盖逻辑才会执行，导致Token被截断；非调试模式下不会触发，因此Token保持正确

另一种可能性是嵌套字典的浅拷贝问题：

• DEFAULT_CONFIG是模块级嵌套字典，config = DEFAULT_CONFIG.copy()为浅拷贝，仅复制顶层字典引用，内部的github字典与DEFAULT_CONFIG共享
• 若调试模式下有其他代码（如日志、监控逻辑）修改了DEFAULT_CONFIG["github"]["token"]，会导致所有基于浅拷贝的配置字典中的Token被同步修改

结合临时解决方案的有效性，第一种原因的概率更高——即调试模式下的后续配置逻辑覆盖了正确的Token值。

内容的提问来源于stack exchange，提问作者r-log