<!DOCTYPE html>

后端接口开发实战

C# 后端接口开发实战：从MySQL到JSON全流程拆解（附SQL注入防护）

最近在整理零点博客的代码库时，发现很多新手在做后端接口开发实战时，最容易被忽视的就是安全性和数据处理细节。很多教程只教怎么跑通，却没教怎么在C#环境中既高效又安全地与MySQL交互。今天，咱们就以一个“获取用户列表”的接口为例，不整虚的，直接从底层逻辑到代码落地，进行一次深度的复盘。

一、 需求分析：不仅仅是返回数据

在开发接口开发时，我们首先要明确入参和出参。我们的目标是构建一个 RESTful 风格的 API，前端通过 HTTP 请求获取数据。为了模拟真实环境，我们假设数据存储在 MySQL 数据库中，我们需要处理好JSON/XML 的序列化与反序列化。

二、 核心代码：C# 与 MySQL 的连接之道

在 .NET Core 或 .NET 5+ 环境下，使用原生 SqlConnection 比较繁琐。为了提升开发效率，建议使用 Dapper 或 EF Core。

1. 配置与连接字符串

别忘了在 appsettings.json 里配置好连接池，这对性能至关重要：

"ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=ZeroBlogDB;User Id=root;Password=your_password;CharSet=utf8mb4;"
}

2. SQL注入防护：预处理语句是底线

做后端开发最怕什么？怕SQL注入！很多初级开发喜欢字符串拼接 sql += " WHERE id = " + id，这是大忌。我们在实战中必须使用预处理语句。下面这段代码展示了如何安全地查询用户：

using (var connection = new SqlConnection(_config.GetConnectionString("DefaultConnection")))
{
    // 严格使用参数化查询
    string sql = "SELECT * FROM Users WHERE CreateTime > @MinTime";

    var parameters = new DynamicParameters();
    parameters.Add("@MinTime", DateTime.Now.AddDays(-7));

    // 执行查询并映射为对象
    var users = connection.Query(sql, parameters).ToList();

    // 自动序列化为 JSON 返回给前端
    return Ok(users);
}

三、 数据处理与正则校验

接口开发不仅仅是查库。当用户在界面上输入乱七八糟的邮箱时，我们需要在 C# 层面先进行校验。这时候 正则表达式 就派上用场了：

public bool ValidateEmail(string email)
{
    if (string.IsNullOrWhiteSpace(email)) return false;

    // 常见的邮箱正则，防止脏数据入库
    string pattern = @"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$";
    return Regex.IsMatch(email, pattern);
}

四、 底层避坑指南与总结

在实战过程中，我遇到过几个坑，分享给大家：

  • 字符集问题： 确保数据库连接串包含 CharSet=utf8mb4，否则中文存储会乱码，尤其是对于博客类应用。
  • 实体映射： 如果没有使用 ORM，手动映射 DataTable 到 Class 会很累，建议使用 AutoMapper 或直接使用 Dapper。
  • 调试技巧： 不要总是等浏览器报错。学会使用 Console.WriteLine 或 VS 的断点调试查看 SQL 语句的实际执行情况。

从数据库到接口，每一个环节都不能掉以轻心。这套流程结合了 C# 强大的类型系统与 MySQL 的稳定性，是构建高可用后端服务的基石。希望这篇基于零点博客经验总结的干货，能帮你少走弯路，搞定复杂的接口开发。