phpenv启动失败本质是php实例、mysql服务或web服务未运行，而非phpenv自身故障；需依次验证php -v、mysql -h 127.0.0.1连接、apache/nginx模块路径及php-fpm配置，并注意caching_sha2_password兼容性问题。
phpenv 启动失败，从来不是 phpenv 本身“没启动”，而是它切换后的 PHP 8.1.31 实例、配套的 MySQL 8.0.36 服务，或两者之间的连接链路出了问题。关键要分清责任边界：phpenv 只管 PATH 和版本软链接，不启服务、不配数据库、不修认证协议。
先确认 PHP 8.1.31 能否独立运行
别急着点“启动全部”，先隔离验证 PHP 是否就绪：
- 执行 phpenv use 8.1.31，再运行 php -v —— 若报“不是内部或外部命令”，说明 phpenv 初始化失败，检查
~/.zshrc（macOS/Linux）或系统环境变量（Windows）是否漏了source $(phpenv root)/bin/phpenv.sh - 若
php -v成功，再跑 php -l php.ini（路径用phpenv which php查到的目录下那个）—— 常见错误是 extension 写错（如extension=php_curl.dll写成extension=curl），或路径含空格未加引号 - Windows 用户注意：PHP 8.1 官方包依赖 Visual C++ 2019 Redistributable (x64)，缺失会导致双击
php.exe弹窗报 DLL 错误；安装后务必重启终端
单独启动并验证 MySQL 8.0.36
MySQL 不是 phpenv 管的，但常被误认为“随环境一起启动”。必须手动确认其状态：
- Windows 下查服务：打开“服务”管理器，找 MySQL80 或你自定义的服务名，看状态是否为“正在运行”；不行就右键“启动”，若秒退，立即查 Windows 事件查看器 → 应用程序日志里对应时间的 MySQL 错误
- Linux/macOS 下运行：sudo lsof -i :3306 看端口是否被占用；再执行 mysqld --console（进 MySQL 的 bin 目录）看控制台报错——高频原因是
datadir权限不对（如 macOS 需chown -R _mysql:_mysql /usr/local/var/mysql）或配置中bind-address写成了::1导致 IPv4 连接被拒 - 无论哪平台，都用命令行直连验证：mysql -u root -p -h 127.0.0.1 -P 3306（强制走 TCP，绕过 socket 争议）；能登录，才说明服务+账号+网络三层通了
检查 PHP 与 MySQL 8.0 的认证兼容性
PHP 8.1.31 默认支持 caching_sha2_password，但若 MySQL 8.0.36 是全新初始化且用户未显式指定插件，仍可能因客户端驱动或旧连接方式触发兼容问题：
- 登录 MySQL 后执行：SELECT user, host, plugin FROM mysql.user WHERE user = 'root'; —— 若 plugin 是
caching_sha2_password，而你的 PHP 连接代码用的是mysqli_connect('localhost', ...)（走 socket），部分环境下仍会静默失败 - 临时解决：执行 ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;
- 代码层加固：连接时明确指定 host 为
127.0.0.1（强制 TCP）、加超时选项，并用mysqli_connect_error()捕获真实错误，而不是只看白屏
排查 Web 服务（Apache/Nginx）与 PHP 的粘合层
phpenv 切换 PHP 版本后，Web 服务不会自动重载 PHP-FPM 或重新加载模块，这是最易忽略的一环：
- Apache 场景：确认
httpd.conf中LoadModule php_module和AddHandler application/x-httpd-php .php已启用，且php_module的路径指向当前 phpenv 版本的libphp.so（Linux/macOS）或php8apache2_4.dll（Windows） - Nginx + PHP-FPM 场景：检查
php-fpm.conf或 pool 配置中php_admin_value[extension_dir]是否指向 8.1.31 的ext目录；再执行 php-fpm -t 验证配置语法，systemctl restart php8.1-fpm（或对应服务名） - 内置服务器测试：用完整路径启动 /path/to/phpenv/versions/8.1.31/bin/php -S 127.0.0.1:8000，绕过 phpenv shell 函数和 PATH 干扰，确认 CLI 层无阻断
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
