Centos上运行DotNet-Core 2.2 WebApi服务时数据库连接空值错误求助

看起来你遇到的核心问题是Configuration.GetConnectionString("DevDatabase")返回了null，导致UseMySQL方法接收到空参数触发「Value cannot be null」错误。下面是一步步的排查和解决思路：

一、先确认配置文件是否被正确部署到服务器 #

这是最常见的原因——发布时appsettings.json没被复制到输出目录，或者服务运行时找不到它：

• 登录CentOS服务器，找到你的Web API发布后的文件夹，检查里面是否存在appsettings.json文件。如果没有，说明发布过程漏了这个文件。
• 修复方法：打开你的项目.csproj文件，添加以下配置确保发布时自动复制配置文件：

<ItemGroup>
  <Content Include="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

重新发布项目并上传到服务器即可。

二、检查服务运行的环境变量与配置加载逻辑 #

.NET Core会根据ASPNETCORE_ENVIRONMENT环境变量加载对应环境的配置文件：

• 执行echo $ASPNETCORE_ENVIRONMENT查看当前服务器的环境变量值。如果是Production，程序会优先加载appsettings.Production.json，如果这个文件不存在才会 fallback 到appsettings.json。
• 解决方式：
  1. 要么把ConnectionStrings节点复制到appsettings.Production.json中（推荐生产环境这么做）；
  2. 要么临时修改环境变量为Development（仅用于测试，不建议生产环境使用）。
• 另外，确保你的Program.cs中使用了默认的配置加载逻辑：

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .UseStartup<Startup>();

CreateDefaultBuilder已经默认包含了加载appsettings.json和对应环境配置文件的逻辑，如果你自定义了配置加载，可能遗漏了这部分。

三、检查systemd服务配置的工作目录（如果用systemd管理服务） #

如果是通过systemd运行你的API服务，一定要确认.service文件中的WorkingDirectory配置正确：

[Service]
WorkingDirectory=/path/to/your/api/publish
ExecStart=/usr/bin/dotnet YourApi.dll
Restart=always
RestartSec=10
SyslogIdentifier=your-api-service
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production

如果WorkingDirectory指向错误，程序会在默认目录（比如/root）运行，找不到appsettings.json，自然读不到连接字符串。

四、排查配置文件的拼写与格式问题 #

虽然这不会直接导致空值错误，但也需要注意：

• 你提供的appsettings.json中，Database=nameOfDatabse里的databse少了一个a，后续连接数据库时会失败，记得修正；
• 确保ConnectionStrings下的键名DevDatabase和代码中GetConnectionString("DevDatabase")完全一致（虽然.NET Core配置键名大小写不敏感，但保持一致能避免不必要的问题）。

临时调试技巧 #

可以在ConfigureServices开头添加日志输出，确认连接字符串是否真的为null：

public void ConfigureServices(IServiceCollection services)
{
    var connString = Configuration.GetConnectionString("DevDatabase");
    Console.WriteLine($"当前读取的连接字符串：{connString}");
    // 或者用ILogger记录日志
    _logger.LogInformation($"当前读取的连接字符串：{connString}");

    // 原有代码
    services.AddDbContext<nameOfContextContext>(options => options.UseMySQL(connString));
    // ...
}

运行服务后查看日志，就能明确是不是配置加载的问题。

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