在NetBeans中使用PHPUnit 11生成代码覆盖率时找不到日志的问题

我在NetBeans中搭配PHPUnit 11运行代码覆盖率功能时，测试可正常执行，但始终收到以下输出：

Full output can be found in Output window.
Coverage log not found!
Perhaps you need to add "whitelist" to your XML configuration?

最初生成的phpunit.xml仅包含空的<phpunit>标签，查阅资料后（PHPUnit 11.1官方文档未提及"whitelist"），我拼凑了如下配置：

<?xml version="1.0"?>

<phpunit colors="false" bootstrap="/../bootstrap.php">
    <source>
        <include>
            <directory suffix=".php">_src/</directory>
        </include>
        <exclude>
            <directory suffix=".php">vendor/</directory>
        </exclude>
    </source>
    <filter>
        <whitelist addUncoveredFilesFromWhitelist="true">
            <directory suffix=".php">_src/</directory>
        </whitelist>
    </filter>
    <coverage>
        <report>
            <clover outputFile="clover.xml"/>
            <cobertura outputFile="cobertura.xml"/>
            <crap4j outputFile="crap4j.xml" threshold="50"/>
            <html outputDirectory="html-coverage" lowUpperBound="50"    highLowerBound="90"/>
            <php outputFile="coverage.php"/>
            <text outputFile="coverage.txt" showUncoveredFiles="false" showOnlySummary="true"/>
            <xml outputDirectory="xml-coverage"/>
        </report>
    </coverage>
</phpunit>

但问题依旧，仍提示Coverage log not found!。想明确：

1. 程序会在何处查找日志？
2. 预期日志位置是哪里？
3. 该如何解决这个问题？

问题分析与解决步骤 #

1. 日志查找逻辑与预期路径 #

NetBeans默认依赖PHPUnit生成的Clover格式日志，预期路径是你在配置中<clover outputFile="clover.xml"/>指定的位置——即项目根目录下的clover.xml。如果路径配置错误、文件未生成或权限不足，都会触发该报错。

2. 核心修复操作 #

• 修正路径配置：
  你的bootstrap="/../bootstrap.php"是向上跳转的相对路径，可能指向错误。换成基于phpunit.xml所在位置的相对路径，比如文件在项目根就写bootstrap="bootstrap.php"，在_src目录下就写bootstrap="_src/bootstrap.php"。同时确认_src/目录确实存在于项目根目录下。

• 移除过时的whitelist配置：
  PHPUnit 10+已废弃<filter>下的<whitelist>，改用<source>标签配置要覆盖的代码目录。当前配置中两者并存会导致冲突，直接删除整个<filter>块即可。

• 简化coverage配置：
  先只保留NetBeans依赖的Clover报告，注释或删除其他报告类型，减少干扰：

  <coverage>
      <report>
          <clover outputFile="clover.xml"/>
      </report>
  </coverage>
  

• 手动验证PHPUnit日志生成：
  打开终端进入项目根目录，执行命令：

  ./vendor/bin/phpunit --coverage-clover clover.xml
  

  执行后检查项目根是否生成clover.xml。如果生成失败，根据终端输出的错误（如目录不存在、权限不足）针对性修复。

• 检查NetBeans PHPUnit配置：
  右键项目→属性→测试→PHPUnit，确认：

  • PHPUnit路径指向正确的vendor/bin/phpunit
  • 代码覆盖率的「Clover XML报告」路径设置为clover.xml（与配置文件一致）

3. 最终修正后的phpunit.xml示例 #

<?xml version="1.0"?>

<phpunit colors="false" bootstrap="bootstrap.php">
    <source>
        <include>
            <directory suffix=".php">_src/</directory>
        </include>
        <exclude>
            <directory suffix=".php">vendor/</directory>
        </exclude>
    </source>
    <coverage>
        <report>
            <clover outputFile="clover.xml"/>
        </report>
    </coverage>
</phpunit>

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