常见问题

接口文档如何配置 AccessToken

1、在项目中打开 Configs/appconfig.json 配置，设置 varifyCode.enable: false

2、接口文档选择中台 Admin，打开认证授权服务-登录接口，点击调试在 raw 选项下输入用户名、密码获取 AccessToken

{
  "userName": "admin",
  "password": "123asd",
  "passwordKey": "",
  "captchaId": "",
  "captchaData": ""
}

3、打开文档管理-全局参数设置，点击添加参数

参数说明

参数	说明
参数名称	Authorization
参数值	Bearer AccessToken，格式为 Bearer+空格+AccessToken
参数类型	header

4、关闭所有已打开接口窗口，重新访问测试接口，请求头部出现已配置的参数则配置成功

项目发布启动提示“缺少 Freesql 数据库实现包：FreeSql.Provider.MySql.dll”

由于 Admin.Core 源码只在 Debug 开发环境中引用多个 Freesql 数据库实现包，所以在发布后启动接口时会提示“缺少 Freesql 数据库实现包：FreeSql.Provider.MySql.dll”

可以单击 ZhonTai.Host 项目，将 Debug 开发环境下的 FreeSql.Provider.MySql 安装包剪切到生产环境中，再重新发布项目即可

<ItemGroup Condition="'$(Configuration)'=='Debug'">
  - <PackageReference Include="FreeSql.Provider.MySql" Version="3.2.825" />
</ItemGroup>

<ItemGroup>
  + <PackageReference Include="FreeSql.Provider.MySql" Version="3.2.825" />
</ItemGroup>

管理员的账号密码是什么

账号 admin 密码 123asd

新增用户默认初始密码可以在 appconfig.json.defaultPassword 中配置

查看角色的菜单权限，提示报错“服务器内部错误”是为什么？

查看错误日志bin\Debug\logs\error.log，会看到Parameter '@cte_pid' must be defined.这样的信息

由于查询用到数据库递归函数， mysql 5.x 版本不支持该函数，解决的办法是升级 mysql 8.0+ 版本，或者更换数据库测试

如何禁用或启用仓储过滤器

禁用删除过滤器

using var _ = _yourRep.DataFilter.Disable(FilterNames.Delete);

仅开启删除过滤器

using var _ = _yourRep.DataFilter.DisableAll();
using var __ = _yourRep.DataFilter.Enable(FilterNames.Delete);

禁用租户过滤器

using var _ = _yourRep.DataFilter.Disable(FilterNames.Tenant);

禁用所有过滤器

using var _ = _yourRep.DataFilter.DisableAll();