使用TYPO3 8.7.10与nimut测试框架时sys_file_metadata表找不到的问题

我来帮你排查这个测试里的数据库表缺失问题，结合TYPO3 8.7版本和Nimut测试框架的特性，你可以从这几个方向逐一验证：

1. 确保测试类正确配置要加载的扩展 #

Nimut的FunctionalTestCase依赖testExtensionsToLoad属性来指定测试需要加载的扩展，这比手动调用loadExtension更可靠。你需要在测试类里添加这个配置，并且保证在父类setUp()之前设置：

use Nimut\TestingFramework\TestCase\FunctionalTestCase;

class YourTestClass extends FunctionalTestCase
{
    protected $testExtensionsToLoad = [
        'filemetadata'
        // 如果是composer安装的TYPO3，也可以用'typo3/cms-filemetadata'
    ];

    protected function setUp()
    {
        parent::setUp();
    }

    // 你的测试方法...
}

这个配置会让测试框架自动加载扩展的ext_tables.sql文件，初始化对应的数据库表。

2. 手动导入SQL文件（如果自动加载失效） #

如果上面的配置没生效，可以在setUp()里手动导入filemetadata的SQL文件，强制创建表：

protected function setUp()
{
    parent::setUp();
    $sqlFile = \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extPath('filemetadata') . 'ext_tables.sql';
    $this->importSqlFile($sqlFile);
}

注意要确保路径正确，extPath()会返回扩展的绝对路径，避免路径错误导致SQL文件找不到。

3. 验证扩展是否真的被加载 #

可以在测试方法里加一行调试代码，确认filemetadata扩展的加载状态：

public function testYourDatabaseQuery()
{
    // 调试：检查扩展是否加载
    var_dump(\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::isLoaded('filemetadata'));
    
    // 你的数据库查询代码...
}

如果返回false，说明扩展加载逻辑有问题，检查testExtensionsToLoad的拼写是否正确，或者是否在父类setUp()之后才设置了这个属性（顺序错了会导致加载失效）。

4. 检查测试数据库的初始化逻辑 #

确保Nimut测试框架使用的是独立的测试数据库，并且每次测试都会重新初始化结构。你可以查看项目根目录的phpunit.xml或者Configuration/Testing/Functional/Configuration.yaml文件，确认：

• 数据库配置指向测试专用库（不要用生产库）
• functional测试的配置里没有禁用SQL导入的选项

5. 清理测试环境缓存 #

TYPO3的缓存可能会干扰扩展加载和SQL导入，测试前可以运行Nimut框架的缓存清理命令：

./vendor/bin/nimut-testing-framework cache:flush

按这个流程排查下来，大概率能解决sys_file_metadata表不存在的问题——最常见的原因就是测试类没有正确指定要加载的filemetadata扩展，导致框架没导入对应的SQL文件。

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