一.项目接口实战错误经验总结
1. 逻辑层静态类调用非静态方法报错，如下
Non-static method App\\Services\\Common\\StatisticBusinessService::getLevelUserCarCount() should not be called statically
问题原因:方法定义时没加static
解决方案：
2.变量类型使用错误，如下
问题原因：传了数组，但是罗层里面判断的是字符串
解决方案：修改成传新字段，在加逻辑判断，避免字段相同冲突
二.接口调试的实战经验总结：
1. 使用 Postman 进行接口测试
Postman 是一款非常强大的接口测试工具，可以用来模拟发送请求和接收响应。可以使用 Postman 来测试接口的各种情况，例如正常情况、异常情况、边界情况等等。
2. 使用环境变量进行配置
在进行接口测试时，通常需要切换不同的环境（如开发环境、测试环境、生产环境）和配置参数（如 API 地址、数据库连接信息等）。可以使用 Postman 中的环境变量功能来实现。
3. 使用断言验证结果
在接口测试中，除了验证接口是否能够正常访问和返回正确的数据之外，还需要验证返回的数据是否符合预期。可以使用 Postman 中的断言功能来验证结果。
4. 测试多种情况
在进行接口测试时，应该涵盖尽可能多的情况，例如正常情况、异常情况、边界情况、并发情况等等。通过测试不同的情况，可以发现代码中的潜在问题，并及时进行修复。
5. 记录测试结果和问题
在进行接口测试时，应该记录测试结果和发现的问题。这些记录可以帮助团队更好地追踪和修复问题，并在下一次测试中避免相同的错误。
6. 集成到 CI/CD 工具中
为了保证代码的质量和稳定性，建议将接口测试集成到 CI/CD 工具中。可以使用 Jenkins、GitLab CI 等工具来自动进行接口测试，并及时通知开发人员和运维人员。
三.在 Laravel 框架中进行接口开发时，以下是一些实战经验总结：
- 使用路由定义接口
在 Laravel 中，可以使用路由来定义接口的访问路径和对应的处理逻辑。建议将接口路由定义在 routes/api.php 文件中，这样可以使代码更加清晰和可维护。
Route::get('/users', 'UserController@index');
Route::post('/users', 'UserController@store');
Route::put('/users/{id}', 'UserController@update');
Route::delete('/users/{id}', 'UserController@destroy');
- 使用控制器处理接口逻辑
建议使用控制器来处理接口的具体逻辑。控制器可以将请求处理、业务逻辑和响应生成等操作封装在一个地方，提高代码的可读性和可维护性。
class UserController extends Controller
{
public function index()
{
// 处理获取用户列表的逻辑
}
public function store(Request $request)
{
// 处理创建新用户的逻辑
}
public function update(Request $request, $id)
{
// 处理更新用户信息的逻辑
}
public function destroy($id)
{
// 处理删除用户的逻辑
}
}
- 使用请求验证
在接口开发中，数据的校验是非常重要的一环。Laravel 提供了强大的表单请求验证功能，可以轻松验证请求参数的合法性。
class StoreUserRequest extends FormRequest
{
public function authorize()
{
return true;
}
public function rules()
{
return [
'name' => 'required|string',
'email' => 'required|email|unique:users',
'password' => 'required|min:6',
];
}
}
在控制器中使用请求类来验证请求参数：
public function store(StoreUserRequest $request)
{
// 参数已经通过验证，可以进行后续操作
}
- 统一响应格式
为了保持接口响应的统一性和可读性，建议在返回数据时使用统一的响应格式，例如 JSON 格式。可以通过自定义响应宏或使用现有的包（如 DingoAPI）来实现。
return response()->json([
'code' => 200,
'message' => 'Success',
'data' => $data,
]);
- 使用异常处理
在接口开发中，异常处理非常重要，可以帮助我们及时捕获并处理代码中的错误。Laravel 提供了异常处理机制，可以通过自定义异常类来处理不同类型的异常情况。
try {
// 执行代码
} catch (Exception $e) {
// 处理异常
}
可以使用 try-catch 块来捕获异常，并根据实际情况进行处理和返回适当的错误信息。
