Pester 5.3使用Mock测试Get-FileHashFromUrl函数写法求助

你当前写的测试属于完全无效的自循环测试，同时原函数也存在可测试性差、资源泄漏的问题，具体问题点：

• 测试直接Mock了待测试的目标函数Get-FileHashFromUrl本身，把你写的业务逻辑完全替换成了硬编码返回值，就算测试100%通过，也证明不了你的函数真的能拉取在线PDF、正确计算哈希，本质是自己测自己。
• 变量赋值顺序错误：Mock定义时引用了$hash变量，但该变量是在Mock定义之后才赋值的，实际执行时Mock拿到的是$null值，逻辑上完全跑不通。
• 原函数硬编码了固定URL，无法复用；异常处理直接返回$Error自动变量，拿不到结构化错误信息；创建的网络流、WebClient对象没有手动释放，会造成资源泄漏；用的WebClient属于已过时的.NET类，不推荐使用。

Pester单元测试的核心原则是：只Mock函数的外部依赖，绝对不要Mock被测函数本身。你的函数依赖两个外部操作：一是发起网络请求拉取文件流，二是调用系统cmdlet计算哈希，这两个才是需要Mock替换的部分，避免测试依赖真实网络环境。

首先优化原函数，提升可测试性与健壮性：

function Get-FileHashFromUrl {
    param(
        [Parameter(Mandatory = $true)]
        [string]$Url,
        [ValidateSet('SHA1', 'SHA256', 'SHA384', 'SHA512', 'MD5')]
        [string]$Algorithm = 'SHA256'
    )
    try {
        $wc = [System.Net.WebClient]::new()
        $stream = $wc.OpenRead($Url)
        $hashResult = Get-FileHash -InputStream $stream -Algorithm $Algorithm
        # 手动释放资源
        $stream.Close()
        $wc.Dispose()
        return $hashResult
    }
    catch {
        # 抛出明确的异常，而不是返回Error变量
        throw "在线文件哈希计算失败: $_"
    }
}

对应Pester 5.3版本的正确测试代码：

BeforeAll {
    # 点载入包含待测试函数的脚本文件
    . $PSScriptRoot\myScript.ps1
}

Describe "Get-FileHashFromUrl 功能测试" {
    BeforeEach {
        # 每个用例执行前重置Mock，避免用例间互相干扰
        # 模拟网络请求返回内存流，不发起真实网络调用
        Mock -CommandName OpenRead -Verifiable -MockWith {
            $testBytes = [System.Text.Encoding]::UTF8.GetBytes("fake pdf content")
            return [System.IO.MemoryStream]::new($testBytes)
        }
        # 模拟哈希计算返回固定结果
        Mock -CommandName Get-FileHash -Verifiable -MockWith {
            [PSCustomObject]@{
                Algorithm = 'SHA256'
                Hash      = '7EE8DB731BF3E5F7CF4C8688930D1EB079738A3372EE18C118F9F4BA22064411'
                Path      = 'InputStream'
            }
        }
    }

    It "传入合法可访问URL时，返回正确的哈希结果" {
        $result = Get-FileHashFromUrl -Url "https://example.com/apps/info.pdf"
        
        # 校验返回值符合预期
        $result.Hash | Should -Be '7EE8DB731BF3E5F7CF4C8688930D1EB079738A3372EE18C118F9F4BA22064411'
        $result.Algorithm | Should -Be 'SHA256'
        
        # 校验依赖调用符合预期
        Should -InvokeVerifiable
        Should -Invoke OpenRead -ParameterFilter { $Url -eq "https://example.com/apps/info.pdf" } -Exactly -Times 1
        Should -Invoke Get-FileHash -Exactly -Times 1
    }

    It "URL无法访问时，抛出明确异常" {
        # 模拟网络请求失败
        Mock -CommandName OpenRead -MockWith { throw "404 Not Found" }
        
        # 校验异常抛出逻辑
        { Get-FileHashFromUrl -Url "https://example.com/not-exist.pdf" } | Should -Throw
        Should -Invoke Get-FileHash -Exactly -Times 0
    }
}

• 单元测试不要依赖真实外部环境：网络请求、数据库操作、文件读写这类不稳定的外部依赖，全部用Mock替换，保证测试在任何环境下都能稳定运行。
• Mock的作用域：写在BeforeEach里的Mock会在每个It块执行前重置，避免不同测试用例的Mock互相污染。
• -Verifiable标记配合Should -InvokeVerifiable，可以快速校验所有标记了该参数的Mock都被正确调用，不用逐个写断言。
• 测试异常场景时，必须把待执行的代码包在{}脚本块中传给Should -Throw，否则异常会直接中断测试执行，无法被断言捕获。

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