如何在Laravel Sail（Docker环境）中修改数据库账号密码？

问题根源 #

Sail的MySQL容器**只会在首次启动（数据卷为空时）**创建.env里配置的数据库用户并赋予权限。后续修改.env后即使重建容器，只要数据卷没清理，MySQL会沿用已有的用户数据，不会自动创建新用户或更新权限，这就是新账号连不上的核心原因。

解决方法（分两种场景） #

场景1：允许清空数据库数据（测试环境适用）

直接清理MySQL数据卷，让容器重新初始化用户：

• 停止并删除容器及关联数据卷：

  sail down -v
  

  -v参数会彻底删除所有容器关联的数据卷，包括存储MySQL用户和数据的卷。
• 重新启动容器：

  sail up -d
  

  此时Sail会读取新的.env配置，自动创建sail2用户并赋予对应数据库的全部权限，之后即可正常连接。

场景2：需要保留现有数据库数据

如果不想丢失现有数据，手动进入MySQL容器给新用户授权：

1. 进入运行中的MySQL容器：

   sail exec mysql bash
   

2. 用原账号登录MySQL：

   mysql -u sail -p
   

   输入原密码password后回车。
3. 创建新用户并授权（替换为你的新账号密码，数据库名改为.env中DB_DATABASE的值，默认是laravel）：

   CREATE USER 'sail2'@'%' IDENTIFIED BY 'password2';
   GRANT ALL PRIVILEGES ON `laravel`.* TO 'sail2'@'%';
   FLUSH PRIVILEGES;
   

4. 退出MySQL和容器，新账号即可正常访问数据库。

验证方式 #

• 用Tinker测试：

  sail tinker
  DB::select("select * from users");
  

• 用Sequel Ace/Table Plus连接时，确保参数和.env一致：
  • 主机：127.0.0.1
  • 端口：.env中DB_PORT（默认3306）
  • 用户：sail2
  • 密码：password2
  • 数据库：DB_DATABASE对应的值

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