一、问题/场景描述
在ThinkPHP项目部署到生产环境后，有时会出现部分新增或修改的路由无法访问，返回404错误，而本地开发环境却一切正常。这是一个典型的缓存未及时更新导致的问题，常发生在项目上线或更新后。
二、原因分析
ThinkPHP框架为了提高性能，默认会将路由信息、配置等数据编译成缓存文件。当项目代码更新（如新增控制器、修改路由定义）后，如果这些缓存文件没有被清除或重新生成，框架仍然会加载旧的缓存数据，导致新的路由规则无法被识别，从而引发404错误。常见的缓存文件包括应用初始化缓存和路由缓存。
三、详细解决步骤
解决此问题的核心是清除并重新生成框架的缓存。以下是详细的操作步骤。
步骤1：清除应用缓存
首先，需要清除ThinkPHP生成的应用缓存文件。这些文件通常位于项目的runtime目录下。可以通过命令行工具进行清除。
# 进入项目根目录
cd /path/to/your/project
# 清除所有缓存（包括模板缓存、日志等）
php think clear
# 或者，更精确地清除编译缓存
php think clear-compiled步骤2：清除路由缓存
路由缓存是导致404问题的直接原因。ThinkPHP 6.x及以上版本有独立的路由缓存文件，需要专门清除。
# 清除路由缓存
php think clear-route
# 对于ThinkPHP 5.x，可能需要手动删除文件
rm -f runtime/route.php步骤3：优化自动加载（可选但推荐）
在清除缓存后，重新生成类的映射文件，可以优化性能并确保所有类被正确加载。
# 生成类库映射文件
php think optimize:autoload
# 生成配置和路由缓存文件（生产环境推荐）
php think optimize:config
php think optimize:route步骤4：检查目录权限
确保Web服务器（如www-data或nginx用户）对项目的runtime目录有读写权限，否则缓存文件可能无法生成。
# 通常需要设置runtime目录权限为755或775，并确保所属用户正确
chmod -R 755 runtime
chown -R www-data:www-data runtime # 根据你的Web服务器用户调整步骤5：重启PHP服务或OPCache
如果服务器开启了PHP OPcache或APCu等字节码缓存，需要重启PHP-FPM服务或清除OPcache，以确保最新的代码生效。
# 重启PHP-FPM（例如使用systemctl）
sudo systemctl restart php-fpm
# 或者，如果无法重启服务，可以在项目中创建一个清除OPcache的脚本（临时方案，注意安全）
# 文件内容：<?php opcache_reset(); ?>四、注意事项
在执行清除缓存操作前，建议先备份生产环境数据。直接在生产环境运行php think clear会清除所有缓存，包括可能存在的会话数据，请在访问量低时操作。对于集群部署，需要确保所有服务器节点的缓存都被同步清除。
五、适用环境
本文主要针对使用ThinkPHP 5.x或6.x框架开发的PHP项目，在Linux服务器环境下部署后遇到的缓存问题。