前言

开发时一定要用管理员模式打开VS或者VSCODE进行开发，同时不要在nuget上直接下载，要去github上下载源代码调试。第一方便调试，第二Surging迭代较快，nuget版本往往不是最新的。

错误

问题：fail: Surging.Core.DotNetty.DotNettyServerMessageListener[0] 服务主机启动失败XXX

1. 使用netstat -ano命令查看报错的端口是否被占用或者是不是当前vs权限不够，不够请用管理员模式打开
2. 新版本中不要使用option.UseDotNettyTransport();该方法已过时，如果在Program中再调用的话会有冲突。

问题：Generic types are not valid arg_paramname_name

接口不支持泛型类型，就是说不能这么写

    [ServiceBundle("api/{Service}")]
    public interface IOracleDBServcie : IServiceKey
    {
        Task<List<T>> Query<T>(string sql);
        Task<T> ExecuteScalar<T>(string sql);
        Task<int> Execute(string sql);
    }

要写成这样,这还是挺坑的，不同的查询得定义不同的类型

    [ServiceBundle("api/{Service}")]
    public interface IOracleDBServcie : IServiceKey
    {
        Task<List<ROUTE_SERVICE_TABLE>> QueryRouteService(string sql);
        Task<List<SERVICE_MASTER_TABLE>> QueryServiceMasterTable(string sql);
        Task<int> ExecuteScalar(string sql);
        Task<int> Execute(string sql);
    }

问题：A suitable constructor for type 'xxx' could not be located. Ensure the type is concrete and services are registered for all parameters of a public constructor

出现这个错误你肯定看了网上一些吊人的文章，跑不起来就往网上放，原因是因为Startup，在使用UseStartup<Startup>()的时候他会判断是否是继承自IStartup还是用的标准的Startup，但网上用的那个是既不是标准的也没有继承IStartup所以报错了，解决方法：换成.netcore项目自己生成的Startup，或者继承IStartup

public class Startup : IStartup

问题：One or more errors occurred.由于目标计算机积极拒绝，无法连接

看下报错的类，比如是在这个类ConsulServiceCacheManager中报错那就是Consul没有联上，看下有没有启动consul或者是地址端口配置的对不对。在Rabbitmq中报错，那就是RBMQ没有联上，一样检查连接
。如果是部署在docker中出现 这个错误，那就是映射的ip和端口不对

开发调试

问题：在代理方法上打了断点进行调试，每次都很快的返回但取不到返回值一直是null

这是由于Surging熔断中的超时配置ExecutionTimeoutInMilliseconds该值默认是一秒，调试的时候手速慢点就会立即返回，所以这个值建议设置成60000（1分钟）

问题：循环任务中在代理方法上打了断点进行调试，刚开始正常但后来每次都很快的返回但取不到返回值一直是null

同样也是熔断的限流配置MaxConcurrentRequests问题，查下你是不是在循环中用了异步或者是用的Parallel.ForEach这类来进行循环，默认最大并发是20，超过这个值就会炸掉，设置的高一点问题解决
下面附上配置字段的一些注解

配置

部署

问题：Docker中部署时配置文件内容未生效

查看你程序中是怎么引用的,可能是反斜杠的问题
错误写法：build.AddCPlatformFile("${surgingpath}|Configs\\surgingSettings.json", optional: false, reloadOnChange: true);
正确写法：build.AddCPlatformFile("${surgingpath}|Configs/surgingSettings.json", optional: false, reloadOnChange: true);

Docker中服务单独部署时的命令

#docker run --name surgingserver --env Mapping_ip=192.168.249.162 --env Mapping_Port=198 --env RootPath=/app --env 
Register_Conn=192.168.249.162:8500 --env EventBusConnection=172.17.0.4 --env Surging_Server_IP=0.0.0.0 -it -p 198:198 surgingserver

配置说明
Mapping_ip：映射的外部IP(环境变量)
Mapping_port：映射的外部端口(环境变量)
RootPath：业务模块存储的根路径(环境变量)
Register_Conn：注册中心地址(环境变量)
EventBusConnection：eventbus 地址(环境变量)
Surging_Server_IP：容器内部IP(环境变量)

通过Docker-compose进行部署

这种方式我只发现了 一个问题，build的内容这么写有问题

service_datainteract:
    build:
      context: .
      dockerfile: Service_DataInteract/Dockerfile
    container_name: service_datainteract

正确写法，我不知道是不是我操作有问题，反正我这边部署的时候有个问题这样写就好了

service_datainteract:
    build:
      context: ./Service_DataInteract
      dockerfile: Dockerfile
    container_name: service_datainteract

结语

我整个开发的时候问题就这么多，可能有些没忘了，总体来说还是比较简单的。
另外比较可惜的是Surging出完2.0就不更新了，作者跑路了。。。。后面只能自己在上面完善了

微信关注我哦！(转载注明出处) 关注我哦