composer audit是唯一官方依赖安全检测命令,需同时满足Composer≥2.5.0、启用experimental.audit、存在有效composer.lock三条件;否则报错或静默跳过。

composer audit 是唯一能自动检测 Composer 依赖安全漏洞的官方命令,但不是装了就能用——它必须满足三个硬条件:Composer ≥ 2.5.0、experimental.audit 全局或项目级启用、composer.lock 文件存在且有效。
怎么确认 audit 命令真能跑起来
很多人执行 composer audit 后没输出、报错或静默退出,根本原因不是网络或权限,而是功能没加载。分三步验证:
- 运行
composer --version,输出必须是2.5.0或更高;低于这个版本会直接报Command "audit" is not defined - 运行
composer list | grep audit,若无结果,说明实验特性未启用:执行composer config --global experimental.audit true - 检查
composer.lock是否真实存在、非空、未被.gitignore忽略;如果只改了composer.json却没运行composer install或composer update,audit就没东西可查
为什么 audit 扫不出已知高危 CVE
常见现象是:别人项目里 monolog/monolog:1.25.0 被爆出反序列化 RCE(CVE-2023-46805),你一模一样的版本却显示 No security vulnerability detected。核心原因有四个:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
composer.lock中该包版本号带dev-前缀(如dev-main),audit主动跳过——安全数据库不收录开发分支 - 用了私有仓库但没在
composer.json的repositories段声明,或该仓库未提供security-advisories兼容元数据 - 镜像源配置错误:比如腾讯云镜像写成
https://mirrors.cloud.tencent.com/composer(缺末尾/),导致请求 404,audit认为“连不上”,直接跳过 - 漏洞本身不在
FriendsOfPHP/security-advisories数据库中——这个库只收主流生态(Symfony、Laravel、Drupal 等)确认过的条目,小众包或新披露未同步的 CVE 不会出现
CI/CD 里怎么让 audit 真正卡住构建
默认行为是“发现任意一条 advisory 就返回非零退出码”,但这对生产环境太粗暴——low 级别漏洞不该阻断上线。推荐组合参数:
-
composer audit --severity=critical --severity=high --no-dev --no-interaction --timeout=30:只关注真正可利用的风险,排除 dev 依赖干扰,防网络卡死 - 结构化输出供脚本判断:
composer audit --format=json --no-dev | jq '.advisories | length',返回数字 0 表示无高危漏洞;别只看退出码,有些镜像会缓存旧结果导致advisories_count字段不准 - 若需临时豁免某个已知可控漏洞,用
--ignore=CVE-2023-12345,但必须在代码注释或SECURITY.md中写明理由和到期时间
audit 扫完之后,下一步最容易被忽略
audit 只报告,不修复、不升级、不改任何文件。但很多人扫完就以为结束了,其实关键动作在后面:
- 确认漏洞是否真实影响:看 advisory 详情里的
affected versions范围,再比对composer.lock中该包的精确安装版本(不是composer.json里的^2.0) - 检查该包是否被实际调用:比如
phpunit/phpunit在require-dev里,但 CI 里没跑测试,运行时根本不会加载,风险极低 - 升级优先走
composer update vendor/package --with-dependencies,避免只升子包导致依赖冲突;若无法升级,必须加运行时防护(如禁用反序列化、限制文件上传类型) - 更新后务必重新运行
composer audit并提交新的composer.lock——很多团队漏掉这步,导致流水线里永远扫出同一个旧漏洞










