0
0

Postman：Postman环境变量：Postman环境变量简介与基础操作

Postman：Postman环境变量：Postman环境变量简介与基础操作

在这里插入图片描述

环境变量概述

环境变量的概念

在Postman中，环境变量是一种用于存储和管理API测试中常用值的机制。这些值可以是URL、API密钥、认证信息等，它们在不同的测试环境中可能有所不同，例如开发、测试、预生产和生产环境。环境变量允许用户在这些环境中切换时，无需手动更改每个请求中的值，从而提高了测试的效率和准确性。

环境变量的作用

环境变量在Postman中的作用主要体现在以下几个方面：

  1. 简化请求配置：通过使用环境变量，可以避免在每个请求中重复输入相同的值，如API端点或认证令牌，使得请求配置更加简洁。
  2. 环境隔离：不同的环境（如开发、测试、生产）可以使用不同的环境变量集，确保测试不会影响生产环境，同时也方便在不同环境中进行切换和测试。
  3. 动态请求构建：环境变量可以动态地构建请求，例如，使用环境变量中的URL基地址与请求路径结合，生成完整的请求URL。
  4. 参数化测试：在编写测试脚本时，可以使用环境变量来参数化测试，使得测试更加灵活和可重用。

环境变量与全局变量的区别

在Postman中，环境变量和全局变量都是用于存储和管理值的，但它们之间存在一些关键的区别：

  • 作用范围：环境变量的作用范围仅限于当前环境，而全局变量则在整个Postman应用中都可访问。
  • 生命周期：环境变量的值在环境切换时会保持不变，除非手动更改。全局变量的值则可以在任何地方被修改，包括预请求脚本和测试脚本。
  • 使用场景：环境变量通常用于存储特定于环境的值，如不同的API端点或认证信息。全局变量则用于存储在整个测试过程中需要共享的值，如测试中生成的唯一ID。

示例：环境变量与全局变量的使用

假设我们正在测试一个API，该API在开发和生产环境中具有不同的URL。我们还希望在测试中生成并使用一个唯一ID。

环境变量设置

在Postman中，我们首先创建两个环境：

  1. Development

和

  1. Production

。在

  1. Development

环境中，我们设置

  1. API_URL

为

  1. https://dev.example.com/api

，在

  1. Production

环境中，我们设置

  1. API_URL

为

  1. https://prod.example.com/api

。

全局变量设置

我们创建一个全局变量

  1. unique_id

，并在预请求脚本中使用JavaScript生成一个随机的唯一ID，然后将其存储在

  1. unique_id

中。

  1. // Pre-request script
  2. pm.globals.set("unique_id", Math.random().toString(36).substring(2,15)+ Math.random().toString(36).substring(2,15));
使用环境变量和全局变量

在请求的URL中，我们使用环境变量

  1. API_URL

和全局变量

  1. unique_id

来构建完整的请求URL。

  1. // Request URL{{API_URL}}/users/{{unique_id}}

当我们在

  1. Development

和

  1. Production

环境之间切换时，请求URL会自动更新为正确的API端点，同时，

  1. unique_id

的值也会在每次请求前被重新生成，确保了测试的准确性和效率。

通过这个例子，我们可以看到环境变量和全局变量在Postman中的重要性和它们各自的使用场景。环境变量用于隔离和管理不同环境的配置，而全局变量则用于在整个测试过程中共享数据。

环境变量的基础操作

创建环境变量

在Postman中，环境变量允许你存储和管理在不同环境中可能变化的值，如API的URL、端口、认证信息等。这使得在测试不同环境（如开发、测试、生产）时，无需修改请求，只需切换环境即可。

步骤

  1. 打开Postman：确保Postman应用程序已打开。
  2. 选择或创建环境：在左上角的环境选择器中，点击“Manage Environments”。
  3. 编辑环境：在弹出的窗口中，选择一个环境或点击“Add”创建一个新的环境。
  4. 添加变量：在环境的变量列表中，点击“Add”按钮，输入变量名和变量值。
  5. 保存环境：点击“Save”按钮保存环境设置。

示例

假设我们需要创建一个环境变量来存储API的URL，我们可以按照以下步骤操作：

  1. 打开环境管理器：点击左上角的环境选择器，选择“Manage Environments”。
  2. 编辑环境：选择“Development”环境，或创建一个新的环境。
  3. 添加变量：在变量列表中，添加一个名为apiUrl的变量，值设为https://dev-api.example.com。
  4. 保存环境：点击保存。
  1. // 在Postman的Pre-request Script中使用环境变量// 设置请求的URL
  2. pm.environment.set("apiUrl","https://dev-api.example.com");// 在请求中使用环境变量url: pm.environment.get("apiUrl")+"/users",

编辑环境变量

编辑环境变量允许你更新已存在的变量值，以适应环境的变化。

步骤

  1. 打开环境管理器：如上所述，通过环境选择器打开“Manage Environments”。
  2. 选择环境：在环境列表中选择你想要编辑的环境。
  3. 编辑变量：找到你想要修改的变量，点击其值，输入新的值。
  4. 保存环境：点击“Save”按钮保存更改。

示例

假设

  1. apiUrl

的值需要从

  1. https://dev-api.example.com

更改为

  1. https://test-api.example.com

：

  1. 打开环境管理器：点击环境选择器，选择“Manage Environments”。
  2. 选择环境：选择“Development”环境。
  3. 编辑变量：找到apiUrl，将其值更改为https://test-api.example.com。
  4. 保存环境：点击保存。
  1. // 在Postman的Test Script中更新环境变量// 假设测试后需要更新API URL
  2. pm.environment.set("apiUrl","https://test-api.example.com");

删除环境变量

删除环境变量可以清理不再需要的变量，保持环境的整洁。

步骤

  1. 打开环境管理器：通过环境选择器打开“Manage Environments”。
  2. 选择环境：在环境列表中选择你想要编辑的环境。
  3. 删除变量：找到你想要删除的变量，点击其右侧的垃圾桶图标。
  4. 保存环境：点击“Save”按钮保存更改。

示例

假设我们不再需要

  1. apiUrl

这个变量：

  1. 打开环境管理器：点击环境选择器，选择“Manage Environments”。
  2. 选择环境：选择“Development”环境。
  3. 删除变量：找到apiUrl，点击其右侧的垃圾桶图标。
  4. 保存环境：点击保存。
  1. // 在Postman的Test Script中删除环境变量// 假设我们不再需要使用apiUrl
  2. pm.environment.unset("apiUrl");

通过以上步骤，你可以有效地在Postman中管理环境变量，提高API测试的效率和准确性。

Postman环境变量：简介与基础操作

使用环境变量

在请求中引用环境变量

在Postman中，环境变量允许你存储和重用敏感信息或动态值，如API密钥、URL、或测试数据，这在处理多个环境（如开发、测试、生产）时特别有用。引用环境变量时，使用双花括号

  1. {{variable_name}}

来嵌入变量值。

示例：使用环境变量设置请求URL

假设你有一个环境变量

  1. base_url

，其值为

  1. https://api.example.com

。你想要向

  1. /users

端点发送一个GET请求。在请求URL中，你可以这样引用环境变量：

  1. 请求URL: {{base_url}}/users

这样，每次你切换环境时，请求URL会自动更新，无需手动更改。

在测试脚本中使用环境变量

Postman的测试脚本允许你在请求后执行JavaScript代码，以验证响应或设置动态值。你可以通过

  1. pm.environment.get('variable_name')

来访问环境变量的值。

示例：在测试脚本中检查响应状态

假设你想要检查一个请求的响应状态是否为200 OK。你可以使用以下测试脚本：

  1. // 测试脚本示例const responseCode = pm.response.code;const expectedCode =parseInt(pm.environment.get('expected_status_code'));try{
  2.     pm.test("检查响应状态",function(){
  3.         pm.expect(responseCode).to.equal(expectedCode);});}catch(error){
  4.     console.error("测试失败: "+ error.message);}

在这个例子中，

  1. expected_status_code

是一个环境变量，其值被设置为200。

环境变量的动态赋值

在测试脚本中，你还可以动态地设置环境变量的值。这在处理API返回的动态数据时非常有用，例如，你可能需要从响应中提取一个令牌并将其存储为环境变量，以便在后续请求中使用。

示例：从响应中提取并设置环境变量

假设API返回一个JSON响应，其中包含一个名为

  1. token

的字段。你可以使用以下测试脚本来提取这个令牌并将其设置为环境变量：

  1. // 测试脚本示例const jsonData = pm.response.json();
  2. pm.environment.set('token', jsonData.token);

在这个例子中，

  1. jsonData.token

是从响应中提取的令牌值，然后使用

  1. pm.environment.set()

函数将其设置为环境变量

  1. token

。

环境变量的管理

Postman允许你通过环境管理界面来创建、编辑和删除环境变量。你可以在“Manage Environments”窗口中进行这些操作，该窗口可以通过点击Postman顶部的环境切换器来访问。

创建环境变量

在“Manage Environments”窗口中，选择一个环境，然后点击“Edit”按钮。在编辑界面中，你可以添加新的变量，输入变量名和初始值。

编辑环境变量

同样在编辑界面，你可以修改现有变量的值。这在你想要更新API密钥或URL时非常有用。

删除环境变量

如果你不再需要某个环境变量，可以在编辑界面中选择它，然后点击“Delete”按钮。

环境变量的使用场景

环境变量在多种场景下都非常有用：

  • 多环境测试：在不同的部署环境（如开发、测试、生产）中使用不同的URL或密钥。
  • 动态数据处理：从API响应中提取动态数据，并在后续请求中使用。
  • 敏感信息管理：存储和重用敏感信息，如API密钥或密码，而无需在请求中硬编码。

通过以上介绍和示例，你应该能够理解如何在Postman中使用环境变量，以及它们在API测试和开发中的重要性。

环境变量的高级应用

环境变量的预设值

在Postman中，环境变量允许你存储和重用值，这对于测试不同环境（如开发、测试、生产）下的API特别有用。预设值是在创建环境时定义的初始值，它们可以被用来初始化环境变量，从而在不同的测试场景中提供一致的起点。

如何设置预设值

  1. 打开Postman，点击环境图标。
  2. 点击新建，创建一个环境。
  3. 在环境变量编辑器中，添加变量并为其设置预设值。

例如，假设你正在测试一个API，需要连接到不同的数据库。你可以为每个环境（开发、测试、生产）设置不同的数据库URL预设值。

  1. 环境名称: 开发环境
  2. 变量: DB_URL
  3. 预设值: "http://dev-database.example.com"

示例：使用预设值

假设你有以下的请求：

  1. // Postman请求
  2. pm.sendRequest({url: pm.environment.get("DB_URL"),method:"GET",headers:{"Content-Type":"application/json"}},function(err, res){
  3.     console.log(res.json());});

在这个例子中，

  1. DB_URL

是一个环境变量，其预设值在不同的环境中可以被改变，从而允许你使用相同的请求代码来测试不同的数据库。

使用环境变量进行参数化

环境变量可以用来参数化请求，这意味着你可以使用变量来动态地改变请求中的某些部分，如URL、头信息或请求体。这在处理需要动态数据的API时非常有用。

如何参数化请求

在请求的任何部分，你可以使用双花括号

  1. {{variable_name}}

来引用环境变量。

例如，假设你有一个API，其URL结构如下：

  1. https://api.example.com/v1/users/{{user_id}}

你可以将

  1. user_id

设置为环境变量，并在请求中使用它。

示例：参数化URL

  1. // Postman请求
  2. pm.sendRequest({url:"https://api.example.com/v1/users/{{user_id}}",method:"GET",headers:{"Content-Type":"application/json"}},function(err, res){
  3.     console.log(res.json());});

在这个例子中，

  1. user_id

是一个环境变量，你可以根据需要在不同的测试中设置不同的值。

环境变量在集合中的应用

在Postman中，集合是一组相关的请求，通常用于自动化测试或API文档。环境变量在集合中的应用可以让你在运行集合时使用不同的环境配置，从而测试API在不同环境下的行为。

如何在集合中使用环境变量

  1. 在Postman中，打开你的集合。
  2. 在集合的预请求脚本或测试脚本中，你可以使用pm.environment.get("variable_name")来获取环境变量的值。

示例：在集合中使用环境变量

假设你有一个集合，其中包含多个请求，这些请求需要访问一个特定的API端点，该端点的URL在不同的环境中有所不同。你可以创建一个环境变量

  1. API_URL

，并在集合的预请求脚本中使用它。

  1. // 集合预请求脚本
  2. pm.sendRequest({url: pm.environment.get("API_URL"),method:"GET",headers:{"Content-Type":"application/json"}},function(err, res){// 根据需要处理响应});

然后，在运行集合时，你可以选择不同的环境，从而使用不同的

  1. API_URL

值。

小结

环境变量的高级应用包括设置预设值、参数化请求以及在集合中使用它们。通过这些技术，你可以更有效地管理测试数据，确保API在各种环境下都能正常工作。记住，环境变量的灵活性和可重用性是Postman测试框架的关键特性之一。

环境变量的管理与共享

管理多个环境

在Postman中，环境变量允许你存储和管理API测试中常用的变量，如URL、端点、认证信息等。这对于处理不同环境（如开发、测试、生产）的API特别有用，因为你可以在每个环境中设置不同的变量值，而无需在请求中硬编码这些值。

创建环境

  1. 打开Postman，点击顶部菜单栏的“管理器”。
  2. 选择“环境”选项卡。
  3. 点击右上角的“新建”按钮，输入环境名称，例如“Development”。
  4. 在新创建的环境中，你可以添加变量，例如base_url，并为其设置值，如https://dev.example.com/api。

切换环境

在Postman中，你可以轻松地在不同环境之间切换，以测试API在不同配置下的行为。

  1. 在Postman的顶部菜单栏，找到环境选择器。
  2. 点击环境选择器，选择你想要使用的环境。

在请求中使用环境变量

在请求的URL、头信息或请求体中，你可以使用双花括号

  1. {{variable_name}}

来引用环境变量。

例如，假设你有一个名为

  1. base_url

的环境变量，你可以这样构建请求URL：

  1. GET {{base_url}}/users

环境变量的导出与导入

导出环境

导出环境变量可以让你备份当前的环境设置，或者与团队成员共享这些设置。

  1. 在“环境”选项卡中，选择你想要导出的环境。
  2. 点击右上角的“更多操作”按钮，选择“导出”。
  3. 选择导出格式，通常选择“JSON”格式，然后点击“导出”。

这将生成一个包含环境变量的JSON文件，例如：

  1. {"id":"unique-id","name":"Development","values":[{"key":"base_url","value":"https://dev.example.com/api","enabled":true}]}

导入环境

导入环境变量可以让你恢复之前导出的环境设置，或者从团队成员那里接收并应用这些设置。

  1. 在“环境”选项卡中，点击右上角的“导入”按钮。
  2. 选择你之前导出的JSON文件，点击“打开”。
  3. Postman将解析文件并创建或更新相应的环境变量。

共享环境变量与团队协作

在团队协作中，共享环境变量可以确保所有团队成员使用相同的配置进行API测试，从而避免因环境配置不同而产生的问题。

共享环境到团队

  1. 在“环境”选项卡中，选择你想要共享的环境。
  2. 点击右上角的“更多操作”按钮，选择“共享”。
  3. 选择你的团队，然后点击“共享”。

从团队接收环境

当团队成员共享了一个环境给你时，你可以在“环境”选项卡中看到一个新的环境条目。

  1. 打开“环境”选项卡。
  2. 你将看到一个名为“团队环境”的列表，其中包含所有共享给你的环境。
  3. 选择并启用你想要使用的团队环境。

同步团队环境

Postman会自动同步团队环境的更改，确保所有成员都使用最新的环境变量。

  1. 当团队环境有更新时，Postman会显示一个通知。
  2. 点击通知，或者手动刷新“环境”选项卡，以获取最新的环境变量。

通过以上步骤，你可以有效地管理Postman中的环境变量，无论是个人使用还是团队协作，都能确保API测试的准确性和一致性。

环境变量的常见问题与解决方法

环境变量未生效的常见原因

在使用Postman进行API测试时，环境变量的正确配置和使用是确保测试顺利进行的关键。然而，有时我们可能会遇到环境变量未生效的情况，这可能是由以下几个常见原因导致的：

  1. 变量未正确设置或保存：确保在Postman的环境设置中，你已经正确地输入了变量的名称和值，并且保存了这些更改。如果变量没有保存，它们将不会在请求中被使用。
  2. 变量作用域问题：Postman中的变量有多个作用域，包括全局变量、环境变量、集合变量和预请求脚本变量。确保你正在使用的变量是在正确的作用域中定义的。例如，如果你在预请求脚本中设置了一个变量，但试图在请求URL中使用它，这可能不会生效，除非你将其设置为全局变量或环境变量。
  3. 变量引用错误：在请求中引用变量时，确保使用了正确的语法。在Postman中，变量应该使用双花括号{{variable_name}}来引用。检查你的请求中是否有拼写错误或引用了不存在的变量。
  4. 缓存问题：Postman有时会缓存请求，这意味着即使你更改了环境变量，旧的请求可能仍然使用缓存的变量值。尝试清除缓存或重启Postman以确保变量更新生效。
  5. Postman版本问题：确保你正在使用最新版本的Postman。一些变量功能可能在旧版本中不可用或存在bug。

示例：检查变量引用

假设你有一个环境变量

  1. base_url

，你希望在请求URL中使用它。如果在请求URL中直接输入

  1. {{base_url}}/users

，但请求失败，可能是因为变量引用错误或变量未正确设置。

正确设置变量

在Postman的环境设置中，确保

  1. base_url

变量被设置为

  1. https://api.example.com

。

检查请求

在请求的URL中，正确引用变量：

  1. GET {{base_url}}/users

如果请求仍然失败，检查

  1. base_url

是否正确保存在环境中，以及请求中是否有其他错误。

调试环境变量的技巧

调试环境变量是确保API测试准确性和效率的重要步骤。以下是一些调试环境变量的技巧：

  1. 使用Postman的“查看”功能：在发送请求之前，使用“查看”功能预览请求。这将显示请求的所有部分，包括URL、头信息和请求体，帮助你确认变量是否被正确引用和替换。
  2. 检查变量值：在Postman的“环境”面板中，你可以查看所有环境变量的当前值。如果变量值为空或不正确，这可能是问题所在。
  3. 使用预请求脚本：预请求脚本允许你在发送请求之前执行JavaScript代码。你可以使用它来设置或更新变量值，甚至检查变量是否设置正确。例如，你可以添加以下代码来检查base_url变量：
  1. // 预请求脚本示例
  2. pm.environment.set("base_url","https://api.example.com");
  3. console.log("Base URL:", pm.environment.get("base_url"));
  1. 查看响应：在请求的响应中，Postman会显示任何设置的变量值。这可以帮助你确认变量是否在请求中被正确使用。
  2. 使用Postman的“测试”脚本：在请求的“测试”选项卡中，你可以编写JavaScript代码来检查请求的响应，并根据需要设置或更新变量。例如，你可以使用以下代码来检查响应状态码是否为200：
  1. // 测试脚本示例
  2. pm.test("Status code is 200",function(){
  3.     pm.response.to.have.status(200);});

如果状态码不是200，你可以进一步检查请求或响应中的问题。

环境变量与请求失败的关联

环境变量的不当使用或配置错误是导致Postman请求失败的常见原因之一。例如，如果一个环境变量被错误地设置为无效的URL或API密钥，请求将无法成功发送。以下是一些环境变量可能导致请求失败的情况：

  1. 无效的URL：如果base_url变量被设置为一个不存在或无法访问的URL，请求将失败。确保URL是正确的，并且API服务正在运行。
  2. 错误的API密钥或认证信息：许多API需要认证才能访问。如果认证信息（如API密钥或令牌）被错误地设置在环境变量中，请求将因认证失败而被拒绝。
  3. 变量值类型不匹配：某些API可能需要特定类型的变量值（如数字或日期）。如果环境变量的值类型不匹配，请求可能无法正确解析，导致失败。
  4. 网络问题：即使环境变量设置正确，网络问题也可能导致请求失败。检查你的网络连接，确保没有防火墙或代理设置阻止了请求。

示例：处理无效的URL

假设你的

  1. base_url

变量被错误地设置为

  1. http://invalidurl.com

，这将导致所有使用该变量的请求失败。

解决方法
  1. 检查并更新环境变量：在Postman的“环境”面板中，找到base_url变量，将其更新为正确的URL，例如https://api.example.com。
  2. 清除缓存：如果更改后请求仍然失败，尝试清除Postman的缓存或重启Postman，以确保使用的是最新的变量值。
  3. 测试网络连接：使用更新后的URL，尝试在浏览器中访问，确认网络连接没有问题。

通过以上步骤，你可以解决因环境变量配置错误导致的请求失败问题，确保你的API测试顺利进行。

标签： postman lua 测试工具
本文转载自: https://blog.csdn.net/weixin_42749425/article/details/142409099
版权归原作者 kkchenjj 所有， 如有侵权，请联系我们删除。
登录后发布评论

“Postman：Postman环境变量：Postman环境变量简介与基础操作”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

网络安全法-网络运行安全

使用selenium/drissionpage时如何阻止chrome自动跳转http到https

docker desktop 里部署的Open WebUI 管理员密码忘记了的处理方法

在ubuntu20.04中搭建onsite比赛运行环境

利用开源的低代码表单设计器FcDesigner高效管理和渲染复杂表单结构

Kafka学习笔记

【前端】浏览器输入url到页面呈现发生了什么？