Composer 不处理 ACL 权限冲突，其报错均为操作系统级文件权限或容器 UID/GID 映射问题；真 ACL 错误（如 RocketMQ 的 plain_acl.yml 校验失败）发生在运行时服务调用阶段，日志含“ACL check failed”等明确提示，与 Composer 的 file_put_contents() Permission denied 完全无关。
Composer 本身不处理 ACL（访问控制列表）引起的权限冲突——它根本不知道 ACL 的存在。所谓“ACL 权限冲突”，实际是操作系统级文件权限或容器运行时用户隔离导致的 Permission denied，和 RocketMQ 或 Tackle 那类应用层 ACL 完全无关。你看到的报错，99% 是 vendor/、composer.lock 或 ~/.composer/cache 目录被 root 占有，或者 Docker 容器里 UID/GID 映射错位。
为什么 composer install 报 Permission denied 却和 ACL 无关
Composer 执行时只做三件事：读 composer.json、写 vendor/ 和 composer.lock、读写缓存目录。它不校验用户角色、不查白名单、不连鉴权服务。所有“ACL 相关”的报错，本质都是 Linux 文件系统权限（ls -ld 看到的 drwxr-xr-x 12 root root）或容器用户上下文错配（比如宿主机用 rocketmq 用户，但容器内跑的是 root）。
- 报错路径含
/root/.composer/或/var/www/.composer/→ 说明COMPOSER_HOME被错误指向非当前用户目录 - 报错在
vendor/autoload.php→ 直接检查ls -ld vendor/，属主不是$(whoami)就得sudo chown -R $USER:$USER vendor/ - Docker Compose 启动失败并提示权限拒绝 → 检查
volumes挂载点的宿主机目录属主是否匹配容器内 UID（例如rocketmq用户 UID=1001，宿主机对应目录就得chown -R 1001:1001 /opt/rocketmq/volumes/broker/store）
怎么区分是 Composer 冲突还是真 ACL 问题
真 ACL 场景（如 RocketMQ Dashboard 或 Tackle）发生在运行时请求阶段，比如 HTTP 请求被拒绝、消息发送被拦截，错误日志里会出现 ACL check failed、no permission to access topic 或明确提到 plain_acl.yml。而 Composer 报错永远是 PHP 的 file_put_contents(): Permission denied 或 fopen(): failed to open stream —— 这两类错误日志格式、发生时机、排查路径完全不同。
- Composer 错误一定出现在终端执行
composer install或composer update时，且带完整文件路径 - ACL 错误一定出现在应用启动后、调用外部服务（如 RocketMQ broker）时，日志在
logs/目录或 HTTP 响应体中 - 如果同时遇到两者，先解决 Composer 权限问题（否则连 vendor 都生成不了），再配置
plain_acl.yml白名单
修复前必须确认的三个位置
别猜路径，直接运行这三条命令，输出里只要有一行属主不是你当前用户名，就是根源：
ls -ld vendor/ ls -ld composer.lock ls -ld $(composer config --global cache-dir)
- 如果
vendor/属主是root：sudo chown -R $USER:$USER vendor/ composer.lock - 如果缓存目录属主是
root：sudo chown -R $USER:$USER $(composer config --global cache-dir) - 如果
~/.composer整个目录都属root：sudo chown -R $USER:$USER ~/.composer
切记：永远不要 chmod -R 777，这会让 vendor/bin/ 下的可执行文件被安全扫描器标记为高危，CI 流水线也会拒绝构建。
真正容易被忽略的是 COMPOSER_HOME 环境变量的隐式覆盖——它可能被 Dockerfile、.env 或 CI 脚本悄悄改写，导致全局命令装到别人家目录里。每次执行 composer global require 前，先敲一遍 composer config --global home 确认落点。
