spatie/laravel-sitemap库setChangeFrequency与setPriority不生效求助

使用spatie/laravel-sitemap生成站点地图时，通过setChangeFrequency和setPriority设置的属性未出现在最终的sitemap.xml文件中，代码如下：

Route::get('/sitemap', function () {
    $sitemap = \Spatie\Sitemap\Sitemap::create()
        ->add(\Spatie\Sitemap\Tags\Url::create('/index')->setPriority(1.0))
        ->add(\Spatie\Sitemap\Tags\Url::create('/contact')->setPriority(0.8))
        ->add(\Spatie\Sitemap\Tags\Url::create('/portfolios')->setPriority(0.7))
        ->add(\Spatie\Sitemap\Tags\Url::create('/services')->setPriority(0.6))
        ->add(\Spatie\Sitemap\Tags\Url::create('/about')->setPriority(0.5));

    \App\Models\Post::all()->each(function (\App\Models\Post $post) use ($sitemap) {
        $url = \Spatie\Sitemap\Tags\Url::create("/posts/{$post->slug}")
            ->setLastModificationDate($post->updated_at)
            ->setChangeFrequency(\Spatie\Sitemap\Tags\Url::CHANGE_FREQUENCY_YEARLY)
            ->setPriority(0.1);
        $sitemap->add($url);
    });
    
    $sitemap->writeToFile(public_path('sitemap.xml'));
    return 'Generated';
});

1. 检查库版本（核心原因） #

如果使用的是spatie/laravel-sitemap v6+版本，这是正常现象：该版本遵循Google最新指南，默认不会输出priority和changefreq属性（Google已不再用这些属性做排名参考）。如果必须输出，需要手动配置。

2. 强制输出属性（v6+适用） #

方式一：单个Url实例手动添加属性 #

修改Url实例的创建代码，直接通过addAttribute方法强制写入属性：

// 静态页面示例
\Spatie\Sitemap\Tags\Url::create('/index')
    ->setPriority(1.0)
    ->addAttribute('priority', 1.0);

// 文章页面示例
$url = \Spatie\Sitemap\Tags\Url::create("/posts/{$post->slug}")
    ->setLastModificationDate($post->updated_at)
    ->setChangeFrequency(\Spatie\Sitemap\Tags\Url::CHANGE_FREQUENCY_YEARLY)
    ->setPriority(0.1)
    ->addAttribute('changefreq', \Spatie\Sitemap\Tags\Url::CHANGE_FREQUENCY_YEARLY)
    ->addAttribute('priority', 0.1);

方式二：全局配置所有Url #

在创建Sitemap实例时，添加全局回调统一处理所有Url的属性输出：

$sitemap = \Spatie\Sitemap\Sitemap::create()
    ->configureUrl(function (\Spatie\Sitemap\Tags\Url $url) {
        // 仅当设置过priority时才添加属性
        if ($url->priority()) {
            $url->addAttribute('priority', $url->priority());
        }
        // 仅当设置过changeFrequency时才添加属性
        if ($url->changeFrequency()) {
            $url->addAttribute('changefreq', $url->changeFrequency());
        }
    });

3. 低版本库排查（v5及以下） #

如果使用的是旧版本：

• 确认setPriority传入的是0.0-1.0之间的浮点数，你的代码中数值符合要求。
• 检查代码中是否有其他逻辑意外覆盖了Url实例的priority或changeFrequency属性。
• 手动删除public/sitemap.xml后重新生成，避免旧缓存文件干扰。

4. 验证结果 #

生成完成后，直接打开public/sitemap.xml文件查看，不要依赖第三方工具解析（部分工具会默认忽略这些非必填属性）。

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