如何用Visual Studio C#制作安装包并添加MySQL引用解决部署数据库问题

一、数据库报错的原因及修复 #

1. "Unknown database 'login'" 问题 #

目标机器的MySQL中未创建login数据库，或是连接字符串里的数据库名拼写错误。

• 修复方式：
  • 手动在目标机器的MySQL中执行CREATE DATABASE IF NOT EXISTS login;创建数据库；也可以在项目启动时自动执行这条SQL，避免手动操作。
  • 检查连接字符串里的database=login拼写是否正确，尽量去掉多余空格（比如你的连接字符串里server = localhost的空格，虽然MySQL能识别，但写成server=localhost更规范）。

2. "caching_sha2_password" 认证失败问题 #

MySQL 8.0+默认使用caching_sha2_password作为认证插件，旧版MySQL驱动不支持该插件，就会触发此错误。

• 两种修复方案：
  • 方案一：修改root用户的认证方式为兼容旧驱动的mysql_native_password：

    ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'qwerty';
    FLUSH PRIVILEGES;
    

  • 方案二：升级项目中的MySQL驱动到最新版本，新版驱动原生支持caching_sha2_password认证。

二、添加MySQL引用的正确方法 #

推荐：通过NuGet包管理器添加 #

1. 右键你的WinForms项目 → 选择「管理NuGet程序包」
2. 切换到「浏览」标签，搜索MySql.Data，选择Oracle官方发布的包，点击「安装」
3. 安装完成后，项目会自动引用所需DLL，无需手动复制文件，部署时可设置自动将依赖复制到输出目录。

手动添加（不推荐） #

1. 下载对应版本的MySQL Connector/NET安装包，安装后在安装目录找到MySql.Data.dll
2. 右键项目 → 「添加」→ 「引用」→ 「浏览」，选中该DLL完成添加
3. 右键引用的MySql.Data → 「属性」，将「复制本地」设为True，编译时会自动把DLL复制到输出文件夹，方便部署打包。

三、创建安装包完成部署 #

使用Visual Studio Installer Projects扩展制作 #

1. 先安装扩展：打开VS → 「扩展」→ 「管理扩展」→ 搜索「Microsoft Visual Studio Installer Projects」，安装后重启VS。
2. 新建安装项目：右键解决方案 → 「添加」→ 「新建项目」→ 搜索「Setup Project」（或「Windows Installer Project」），命名后创建。
3. 配置项目：
   • 在「文件系统」窗口，右键「应用程序文件夹」→ 「添加」→ 「项目输出」，选择你的WinForms项目的「主输出」和「内容文件」。
   • 如果目标机器未安装MySQL驱动，可将MySQL Connector/NET的安装包（如mysql-connector-net-xxx.msi）添加到安装项目，设置为「必备组件」，安装时会自动先安装驱动。
4. 生成安装包：右键安装项目 → 「生成」，输出目录会生成.msi和.exe文件，直接在目标机器运行即可完成安装。

部署注意事项 #

• 目标机器必须安装与项目版本一致的.NET Framework。
• 如果数据库是本地部署，目标机器需先安装MySQL，且提前创建好login数据库和register表（或在项目启动时自动执行建表脚本）。

四、你的代码中的潜在问题 #

你贴的注册代码存在几个需修正的问题：

1. connection.Open()放在try块外，连接失败会直接崩溃，无异常处理。
2. 连续设置cmd.CommandText，第二个语句会覆盖第一个，导致ALTER TABLE语句根本不会执行。
3. 同时调用adapter.Fill(table)和cmd.ExecuteNonQuery()，会重复执行插入语句，完全没必要。
4. catch块直接throw，用户看不到任何错误提示，体验极差。

修正后的代码示例：

public partial class registration : Form
{
    // 规范连接字符串，去掉多余空格
    string connectionstring = "server=localhost;user id=root;database=login;password=qwerty;";

    // 注册按钮点击事件
    private void btnRegister_Click(object sender, EventArgs e)
    {
        // 使用using块自动释放连接，无需手动关闭
        using (MySqlConnection connection = new MySqlConnection(connectionstring))
        {
            try
            {
                connection.Open();

                // 添加唯一索引的语句只需执行一次，建议放在数据库初始化脚本中，不要每次注册都执行
                using (MySqlCommand alterCmd = new MySqlCommand("ALTER TABLE register ADD UNIQUE INDEX(rgstrid);", connection))
                {
                    try
                    {
                        alterCmd.ExecuteNonQuery();
                    }
                    catch (MySqlException ex)
                    {
                        // 索引已存在则忽略错误（MySQL错误码1061为重复索引）
                        if (ex.Number != 1061)
                            throw;
                    }
                }

                // 执行插入操作
                using (MySqlCommand insertCmd = new MySqlCommand("INSERT IGNORE INTO register(username, password, confirm) VALUES(@username,@password,@confirm)", connection))
                {
                    insertCmd.Parameters.Add("@username", MySqlDbType.VarChar).Value = rgstrusrnmtxtbx.Text;
                    insertCmd.Parameters.Add("@password", MySqlDbType.VarChar).Value = rgstrpswdtxtbx.Text;
                    insertCmd.Parameters.Add("@confirm", MySqlDbType.VarChar).Value = rgstrcnfrmtxtbx.Text;

                    int affectedRows = insertCmd.ExecuteNonQuery();
                    if (affectedRows == 1)
                    {
                        MessageBox.Show("账户注册成功", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information);
                    }
                    else
                    {
                        MessageBox.Show("该账户已存在，未重复创建", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information);
                    }
                }
            }
            catch (Exception ex)
            {
                // 给用户显示具体错误信息
                MessageBox.Show($"注册失败：{ex.Message}", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
        }
    }
}

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