私钥格式错误的典型报错包括Invalid private key、SSL3_GET_SERVER_CERTIFICATE或Could not parse private key；根本原因是私钥内容结构非法，如含BOM头、零宽空格、DOS换行或非Base64字符，需用OpenSSL或ssh-keygen验证并清理格式。
私钥格式错误的典型报错长什么样
看到类似 Invalid private key、error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE 或 Could not parse private key，基本可以确定是私钥文件本身出了问题——不是权限不对，也不是密码输错，而是内容结构非法。
检查私钥文件是否含非法字符或换行污染
私钥必须严格符合 PEM 格式：以 -----BEGIN RSA PRIVATE KEY----- 或 -----BEGIN OPENSSH PRIVATE KEY----- 开头，以 -----END ...----- 结尾，中间只能是 Base64 字符（A-Za-z0-9+/=），不能有空格、中文引号、BOM 头、零宽空格（U+200B）或 Windows 换行符（\r\n）。
- 用
file -i your_key.pem看编码，非us-ascii或utf-8（且无 BOM）要重导出 - 用
head -n 1 your_key.pem | od -c查看开头是否有隐藏字符（比如\357\273\277是 UTF-8 BOM） - 用
sed -i 's/\r$//' your_key.pem（Linux/macOS）清理 DOS 换行 - 别从网页复制、别用 Word/记事本保存——用 VS Code 或 vim，关闭「自动格式化」和「智能引号」
确认私钥类型与 Composer 配置方式匹配
Composer 支持两种私钥使用场景，但要求严格对应：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 用于
http-basic认证（如私有 Packagist 镜像）：用户名填公钥 ID（如pubkey_abc），密码填完整私钥内容（含-----BEGIN...块），且必须用composer config --global http-basic.example.com username password写入，不能手写auth.json - 用于 SSH 克隆私有 Git 仓库：私钥必须放在
~/.ssh/id_rsa或自定义路径，并在~/.ssh/config中显式声明IdentityFile；Composer 不直接读私钥文件，它调用git，而git依赖 SSH 配置路由 - 若用
git@URL 却没配~/.ssh/config，Composer 会 fallback 到默认密钥，但一旦私钥格式错，SSH 直接拒绝，报错看似是 Composer 问题，实为底层 SSH 拒绝加载
验证私钥能否被 OpenSSL 正确读取
绕过 Composer，直接用系统工具验证私钥有效性：
- 运行
openssl rsa -in your_key.pem -check -noout—— 成功则输出RSA key ok，失败会明确提示哪行错（如unable to load Private Key或bad base64 decode） - 如果是 OpenSSH 格式（
-----BEGIN OPENSSH PRIVATE KEY-----），改用ssh-keygen -lf your_key.pem；若报invalid format，说明不是标准 OpenSSH 私钥 - 别信 GitHub/GitLab 页面上“复制私钥”的按钮——有些 UI 会悄悄加空格或换行，务必用
cat your_key.pem | pbcopy（macOS）或cat your_key.pem | xclip -sel clip（Linux）确保原样复制
真正卡住的地方往往不是 Composer 配置，而是私钥文件本身在编辑、传输、粘贴过程中被破坏。修复前先用 OpenSSL 验证，比反复改 auth.json 或重装 Composer 有效得多。
