新建Snipe-IT容器无法连接已部署MySQL容器的问题如何解决？

1. 验证容器网络连通性 #

• 首先确认两个容器是否同属目标网络，执行命令：
  docker inspect mysql_default | grep -A20 "Containers"
  若输出中未同时出现MySQL容器和snipeit容器，手动将MySQL容器加入对应网络：
  docker network connect mysql_default <替换为你的MySQL容器名>
• 进入Snipe-IT容器测试网络可达性：
  docker exec -it snipeit ping <替换为你的MySQL容器名>
  如果ping不通，检查Docker网络插件是否正常运行、容器是否处于正常运行状态。

2. 验证MySQL权限与服务可用性 #

进入Snipe-IT容器，直接用内置MySQL客户端发起连接测试：
docker exec -it snipeit mysql -h<替换为MySQL容器名> -u<替换为你配置的数据库用户名> -p<替换为你配置的数据库密码>
根据报错对应处理：

• Unknown database 报错：未提前创建对应名称的数据库，进入MySQL容器创建匹配配置的数据库即可
• Access denied 报错：数据库用户未开放远程访问权限，进入MySQL容器执行授权：
  GRANT ALL PRIVILEGES ON <替换为数据库名>.* TO '<替换为数据库用户名>'@'%' IDENTIFIED BY '<替换为数据库密码>'; FLUSH PRIVILEGES;
• Connection refused 报错：检查MySQL容器内部是否正常监听3306端口，配置的数据库端口是否和MySQL容器内部监听端口一致。

3. 验证环境变量是否正常加载 #

很多时候配置文件正确但参数未被容器正常读取，执行命令查看容器内生效的数据库配置：
docker exec -it snipeit env | grep DB_
重点核对：

• DB_HOST必须填写MySQL容器名，不能填127.0.0.1或宿主机IP
• 所有参数是否存在多余空格、特殊字符未转义的问题
• 数据库端口、库名、用户名、密码是否和MySQL侧配置完全匹配

4. 查看容器日志定位细节错误 #

Web端提示信息比较笼统，直接查看Snipe-IT运行日志获取具体报错：
docker logs snipeit
重点检索数据库连接相关的报错，可定位到比如PHP扩展缺失、配置参数格式错误等隐藏问题。

5. 特殊场景排查 #

• 不要在数据库端口配置项填写宿主机映射的MySQL端口，必须填写MySQL容器内部监听的默认3306端口
• 若数据库密码包含$、&、!等特殊字符，需在env文件中给密码值包裹单引号避免被shell转义
• 执行docker ps检查MySQL容器是否处于正常运行状态，排除容器频繁重启、服务异常退出的问题

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