向manifest.xml添加tax provider致Shopware 6.5应用无法被识别

我们正在开发Shopware 6的Tax Provider应用，按照官方文档要求在manifest.xml中添加税务定义，但添加以下<tax>配置代码后，应用在Shopware 6.5全版本（6.5.0.0至6.5.1.1）中均无法被识别；移除该配置后应用可正常被识别。

<tax>
    <tax-provider>
        <identifier>myCustomTaxProvider</identifier>                        <!-- Unique identifier of the tax provider -->
        <name>My custom tax provider</name>                                 <!-- Display name of the tax provider -->    
        <priority>1</priority>                                              <!-- Priority of the tax provider - can be changed in the administration as well -->
        <processUrl>https://tax-provider.app/provide-taxes</processUrl>     <!-- Url of your implementation - is called during checkout to provide taxes -->
    </tax-provider>
</tax>

现象说明：

• 无配置时：应用正常显示在Shopware后台，可被识别
• 添加配置后：后台无该应用条目，无法被系统识别

解决思路 #

• 检查XML语法与命名空间
  确认manifest.xml根元素的命名空间和Schema版本匹配Shopware 6.5要求。比如根节点需正确声明：

  <manifest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/shopware/platform/trunk/src/Core/Framework/App/Manifest/Schema/manifest-1.0.xsd">
  

  命名空间或Schema版本不匹配会直接导致配置解析失败。

• 验证processUrl格式与可访问性
  Shopware 6.5可能会预校验processUrl的合法性，尝试替换为无特殊字符的绝对URL，或暂时用本地测试地址（如http://localhost:8000/provide-taxes）测试，排查是否因URL问题导致识别失败。

• 查看Shopware系统日志
  检查var/log/prod.log或后台系统日志模块，应用识别失败时通常会有XML解析错误、配置验证失败等具体报错，根据日志定位问题根源。

• 确认配置节点层级
  确保<tax>节点是<manifest>根节点的直接子节点，不要嵌套在<extensions>、<permissions>等其他节点内部，层级错误会导致系统无法读取配置。

• 简化配置排查
  先保留必填项（identifier、name、processUrl），移除注释和priority节点，测试应用是否能被识别。如果可以，再逐步添加其他配置项，定位具体触发问题的字段。

• 检查应用压缩包结构
  确保应用压缩包的manifest.xml在根目录，无多余嵌套文件夹，结构不符合要求会导致系统无法正确读取配置文件。

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