TYPO3 v13安装失败：数据库主机'db'解析错误求助

一、修复数据库主机名解析错误 #

错误php_network_getaddresses: getaddrinfo for db failed是系统无法识别主机名db导致的，按以下场景排查修复：

场景1：未使用Docker/容器环境 #

db是Docker容器化环境的数据库服务别名，本地直接运行TYPO3时必须替换为真实主机地址：

• 把数据库主机名改成localhost或127.0.0.1（本地部署数据库的情况）
• 若数据库在远程服务器，填写对应服务器的IP或域名

场景2：使用Docker/容器环境 #

1. 确认TYPO3容器和数据库容器处于同一个Docker网络
2. 检查数据库容器的服务名是否确实为db（查看docker-compose.yml或容器配置）
3. 临时用容器IP替代：执行docker inspect db | grep "IPAddress"获取数据库容器IP，用该IP替换db测试连接

额外验证步骤 #

• 用MySQL客户端测试连接：mysql -h 127.0.0.1 -u julian -p，确认用户名、密码、端口有效
• 确保数据库服务在运行：
  • Linux/macOS：systemctl status mariadb（或mysql服务）
  • Windows：在系统服务列表中确认MySQL服务已启动

二、修复install.php无法加载问题 #

1. 本地域名配置：
   编辑系统hosts文件（Windows：C:\Windows\System32\drivers\etc\hosts；Linux/macOS：/etc/hosts），添加一行：

   127.0.0.1 example-project-site.local
   

2. Web服务器配置验证：
   确保Apache/Nginx的虚拟主机已指向TYPO3项目的public目录，示例Nginx配置片段：

   server {
       listen 80;
       server_name example-project-site.local;
       root /path/to/example-project-directory/public;
       index index.php;
   
       location / {
           try_files $uri $uri/ /index.php?$args;
       }
   
       location ~ \.php$ {
           fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 根据你的PHP版本调整
           fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
           include fastcgi_params;
       }
   }
   

3. HTTPS临时处理：
   若未配置有效SSL证书，先尝试用http://example-project-site.local/typo3/install.php访问；需HTTPS的话，可用mkcert生成自签证书并配置到Web服务器

三、重新执行安装 #

解决上述问题后，回到项目根目录，重新运行：

./vendor/bin/typo3 setup

或通过浏览器访问修复后的install.php页面完成安装

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