tp8 cli 启动失败主因是 php 版本低于 8.0 或 vendor 目录不完整；自定义指令需严格置于 app/console/ 下、命名空间为 app\console、类名与文件名一致；缓存失效时须执行 php think clear --console；nohup 运行需用绝对路径并确保环境变量和日志路径有效。
think 命令报 Class 'think\App' not found
这是 TP8 CLI 指令启动失败最典型的症状，不是指令类写错了，而是整个框架根本没加载起来。根本原因只有两个：PHP 版本低于 8.0，或 vendor/ 目录不完整。
执行 php -v 确认 CLI 模式下是 PHP 8.1 或 8.2；再检查 public/index.php 第 16 行是否提示 autoload.php 找不到——这说明 composer install 没跑完或中途失败。
- 不要删项目重来，先进入根目录运行
composer install - 若报
Permission denied，检查当前用户对vendor/和runtime/是否有写权限 - 确认
runtime/目录存在且可写：mkdir -p runtime/log runtime/cache runtime/session，再chown -R www:www runtime/
自定义指令类找不到，app\console\Hello 不被识别
TP8 要求指令类必须放在 app/console/ 下，且命名空间严格匹配目录结构。常见错误是：类文件放在 app/command/（TP6 风格）、命名空间写成 app\command、或文件名大小写不一致（如 Hello.php 但类名是 hello）。
正确结构示例：
app/ ├── console/ │ └── Hello.php ← 文件名首字母大写
对应类定义必须为：
namespace app\console;
use think\console\Command;
use think\console\Input;
use think\console\Output;
class Hello extends Command
{
protected function configure()
{
$this->setName('hello')
->setDescription('Say hello to someone');
}
protected function execute(Input $input, Output $output)
{
$output->writeln('Hello, World!');
}
}
- 类名必须与文件名完全一致（区分大小写）
- 命名空间必须是
app\console，不能是app\command或app\Console - 确保该类继承
think\console\Command，而非旧版的think\command\Command
执行 php think hello 提示 command not found
不是类没注册，而是 TP8 的指令发现机制依赖自动扫描，而扫描只在首次运行时触发，并缓存到 runtime/console/。如果改过类名、移动过文件、或清过 runtime/，缓存就失效了。
解决方法很简单：手动刷新指令缓存。
- 运行
php think clear --console清空控制台缓存 - 再执行
php think list，确认hello出现在命令列表里 - 如果仍不出现，检查
app/console/下是否有多余的 .php 文件（比如备份文件Hello.php.bak），TP8 会尝试加载它并因语法错误静默跳过整个目录
nohup 启动后指令无声退出，日志只有一行
这是因为 nohup php think hello & 在后台运行时，CLI 模式默认加载的是 .env 中的 APP_ENV=production，而部分配置（如数据库连接、日志驱动）在 production 下未启用或路径不可写，导致执行中途崩溃且无输出。
更关键的是：TP8 的指令环境初始化依赖 think\console\Application 加载完整的应用上下文，而 nohup 会丢失某些环境变量或工作路径。
- 始终用绝对路径运行：
nohup /usr/bin/php /var/www/tp8/think hello > /var/log/hello.log 2>&1 & - 在指令
execute()开头加error_log("start at " . date('Y-m-d H:i:s'), 3, '/tmp/hello-debug.log');确认是否真正进入 - 避免在指令中直接调用
Db::或Log::，先验证App::env('APP_ENV')是否为预期值
php think list 输出是否包含你的命令。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
