微信小程序开发 request

### 微信小程序开发中 `request` 请求使用教程

#### 一、基础概念
在网络请求方面，微信小程序提供了内置函数 `wx.request()` 来发起 HTTP/HTTPS 网络请求。这使得开发者能够轻松地与服务器端通信，从而获取或提交数据[^2]。

#### 二、基本语法
以下是 `wx.request()` 方法的基本语法：

wx.request({
    url: '', // 接口地址
    data: {}, // 请求参数
    method: 'GET', // 默认为 GET 可选 POST PUT DELETE HEAD OPTIONS TRACE CONNECT PATCH
    header: {
        'content-type': 'application/json' // 设置请求头，默认为 application/json
    },
    success(res) { // 成功回调
        console.log('success:', res);
    },
    fail(err) { // 失败回调
        console.error('fail:', err);
    }
})

此段代码展示了如何构建一个简单的网络请求并处理响应结果[^1]。

#### 三、封装全局 URL 和自定义请求方法
为了使项目更加模块化和易于管理，可以考虑创建一个公共的方法来进行统一配置，比如设置全局的基础路径等操作。下面是一个基于上述思路的例子：

// utils/request.js 文件内定义了一个名为 wxRequest 的工具类用于发送带默认选项的请求
const app = getApp();

function wxRequest(method, path, params={}, callback){
    return new Promise((resolve,reject)=>{
        wx.request({
            url:`${app.globalData.baseUrl}${path}`, 
            data:params,
            method,
            header:{
                "Content-Type":"application/x-www-form-urlencoded"
            },
            success:(response)=>{ resolve(response);callback&&callback(null,response)},
            fail:error=>{ reject(error);callback&&callback(error)}
        })
    });
}

module.exports={
    wxRequest
}

页面逻辑层可以直接引入该文件并通过它来执行各种类型的HTTP请求而无需重复编写相同的代码片段[^4]。

#### 四、错误处理机制
当遇到异常情况时（如超时、断网），应该有合理的提示给到用户；同时也要记录下这些异常信息以便后续排查问题所在。对于可能出现的各种状况都应提前做好预案，在 catch 中加入相应的日志打印语句可以帮助定位线上 bug 。另外还可以利用 try-catch 结构包裹异步调用来捕获未预见的 runtime errors [^3].