本文旨在解决 Laravel Sanctum 在本地开发环境运行正常，但在生产环境出现 "Unauthenticated." 错误的问题。主要原因是服务器 PHP 版本过低，Sanctum 需要 PHP 7.4 或更高版本才能正常运行。本文将提供详细的排查和解决方案，帮助开发者顺利部署 Sanctum 到生产环境。
在使用 Laravel Sanctum 为移动应用生成 API Token 时，可能会遇到一个常见问题：在本地开发环境（例如使用 php artisan serve）一切正常，但在生产环境中却始终返回 "Unauthenticated." 错误，即使登录成功并生成了 Token。Token 已经成功存储到数据库，但请求仍然无法通过身份验证。
原因分析：PHP 版本不兼容
最常见的原因是生产服务器上使用的 PHP 版本低于 Laravel Sanctum 的最低要求。Sanctum 需要 PHP 7.4 或更高版本才能正常运行。
解决方案：升级 PHP 版本
-
确认服务器 PHP 版本：
首先，需要确认生产服务器上正在运行的 PHP 版本。可以通过以下方法查看：
- 通过 SSH 登录服务器，运行 php -v 命令。
- 创建一个 PHP 文件，例如 phpinfo.php，包含以下代码：
将该文件上传到服务器，通过浏览器访问该文件，即可查看详细的 PHP 信息，包括版本号。
-
升级 PHP 版本：
如果服务器 PHP 版本低于 7.4，则需要升级。升级方法取决于服务器的操作系统和配置。以下是一些常见操作系统的升级方法：
- Ubuntu/Debian：
可以使用 apt 包管理器升级 PHP。例如，升级到 PHP 7.4：
sudo apt update sudo apt install php7.4 php7.4-cli php7.4-fpm php7.4-mysql php7.4-xml php7.4-gd php7.4-curl
然后，需要配置 Web 服务器（例如 Nginx 或 Apache）以使用新的 PHP 版本。
- CentOS/RHEL：
可以使用 yum 包管理器升级 PHP。可能需要添加第三方源，例如 Remi Repository。
sudo yum install remi-release sudo yum --enablerepo=remi-php74 install php php-cli php-fpm php-mysqlnd php-xml php-gd php-curl
同样，需要配置 Web 服务器以使用新的 PHP 版本。
- cPanel/WHM：
cPanel/WHM 通常提供一个图形界面来管理 PHP 版本。可以在 cPanel/WHM 控制面板中选择所需的 PHP 版本。
-
重启 Web 服务器和 PHP-FPM：
升级 PHP 版本后，务必重启 Web 服务器（例如 Nginx 或 Apache）和 PHP-FPM 服务，以使更改生效。
sudo systemctl restart nginx # 或 sudo service nginx restart sudo systemctl restart php7.4-fpm # 替换为实际的 PHP-FPM 服务名称
-
验证 Sanctum 功能：
升级 PHP 版本并重启服务后，重新测试 Sanctum 的 API 身份验证功能。应该不再出现 "Unauthenticated." 错误。
注意事项：
- 在升级 PHP 版本之前，务必备份服务器数据，以防意外情况发生。
- 确保升级后的 PHP 版本与 Laravel 项目的其他依赖项兼容。
- 如果使用了缓存，请清除缓存，以确保使用最新的代码和配置。
- 检查 .env 文件中的 APP_URL 是否正确配置，确保与生产环境的域名一致。
- 确保 config/cors.php 文件中的 CORS 配置允许来自移动应用的请求。
- 检查数据库连接配置是否正确，确保 Laravel 可以连接到生产环境的数据库。
总结：
Laravel Sanctum 在生产环境出现 "Unauthenticated." 错误，通常是由于 PHP 版本不兼容造成的。升级 PHP 版本到 7.4 或更高版本通常可以解决此问题。在升级 PHP 版本之前，务必备份数据，并确保升级后的版本与 Laravel 项目的其他依赖项兼容。升级后，重启 Web 服务器和 PHP-FPM 服务，并清除缓存。通过以上步骤，可以成功将 Laravel Sanctum 部署到生产环境，并为移动应用提供安全的 API 身份验证服务。
