在php-fpm Docker镜像中为www-data用户配置Git用户名遇权限问题求解

核心问题分析 #

报错could not lock config file /var/www/.gitconfig: Permission denied的本质是：www-data用户没有/var/www目录的写入权限。Git修改全局配置时，会在配置文件所在目录创建临时的.gitconfig.lock文件，仅修改.gitconfig文件的权限不足以解决这个问题。

分步解决步骤 #

1. 修复/var/www目录权限
   先确保www-data用户拥有该目录的所有权及必要的写入权限：

   chown -R www-data:www-data /var/www
   chmod -R 755 /var/www
   

   755权限保证目录所有者（www-data）具备读写执行权限，其他用户仅拥有只读权限，兼顾功能与安全性。

2. 使用更适配Docker的命令执行Git配置
   Docker环境下推荐用runuser替代su，避免shell环境变量冲突：

   runuser -u www-data -- git config --global user.name "<my-user>"
   

   若必须使用su，可指定完整shell路径以规避环境问题：

   su www-data -s /bin/bash -c 'git config --global user.name "<my-user>"'
   

3. 直接指定配置文件路径（备选方案）
   如果全局配置路径仍存在问题，可直接指定.gitconfig文件路径绕开全局设置逻辑：

   su www-data -s /bin/sh -c 'git config --file /var/www/.gitconfig user.name "<my-user>"'
   

验证配置结果 #

执行完配置命令后，用以下命令确认配置生效：

su www-data -s /bin/sh -c 'git config --global user.name'

若输出你的目标用户名，说明配置成功。

内容的提问来源于stack exchange，提问作者Mohamed Ayadi