使用Docker部署Spring Boot API与MySQL时git add无法索引mysql.sock报错

核心原因 #

mysql.sock是MySQL的Unix域套接字文件，属于特殊设备文件，Git本身不支持追踪这类非普通文件。另外如果该文件之前已被Git追踪过，后续添加的.gitignore规则不会自动生效。

解决步骤 #

1. 移除已追踪的mysql.sock（若之前被添加过）
   执行以下命令，将该文件从Git追踪列表中移除，但保留本地文件：

   git rm --cached scheduling-system-server/docker/volume-mysql/mysql.sock
   

   注意：不要省略--cached，否则会删除本地的套接字文件。

2. 正确配置.gitignore规则
   在项目根目录的.gitignore文件中添加以下规则，精准匹配该文件路径：

   # 忽略MySQL Unix套接字文件
   scheduling-system-server/docker/volume-mysql/mysql.sock
   

   或者用更通用的规则忽略所有套接字文件：

   *.sock
   

   保存文件后，执行git add .gitignore提交配置变更。

3. 验证并提交代码
   再次执行git add .，此时不会再出现mysql.sock相关的错误提示，正常提交代码即可。

额外建议 #

Docker挂载的volume-mysql目录通常包含数据库运行时生成的临时文件、日志、套接字等，这些都不适合纳入版本控制。建议直接把整个目录加入.gitignore：

scheduling-system-server/docker/volume-mysql/

这样能避免后续出现类似的其他文件追踪问题。

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