docs/content/zh-cn/docs/faq/faq.md

@@ -0,0 +1,75 @@
+---
+title: 常见问题列表
+weight: 10
+---
+
+#### 问题 1-1：模块 compile 引入 springboot 依赖，模块安装时报错
+```text
+java.lang.IllegalArgumentException: Cannot instantiate interface org.springframework.context.ApplicationListener : com.alipay.sofa.serverless.common.spring.ServerlessApplicationListener
+```
+##### 解决方式
+模块需要做好瘦身，参考这里：[模块瘦身](/docs/tutorials/module-development/module-slimming.md)
+
+#### 问题 1-2：模块安装找不到 `ServerlessApplicationListener`
+报错信息如下：
+```text
+com.alipay.sofa.ark.exception.ArkLoaderException: [ArkBiz Loader] module1:1.0-SNAPSHOT : can not load class: com.alipay.sofa.serverless.common.spring.ServerlessApplicationListener
+```
+##### 解决方式
+请在模块里面添加如下依赖：
+```xml
+<dependency>
+    <groupId>com.alipay.sofa.serverless</igroupId>
+    <artifactId>sofa-serverless-app-starter</artifactId>
+    <version>0.5.5</version>
+</dependency>
+```
+或者升级 sofa-serverless 版本到最新版本
+
+#### 问题 1-3: 通过 go install 无法安装 arkctl
+执行如下命令，报错
+```shell
+go install serverless.alipay.com/sofa-serverless/v1/arkctl@latest
+```
+报错信息如下：
+```text
+go: serverless.alipay.com/sofa-serverless/v1/arkctl@latest: module serverless.alipay.com/sofa-serverless/v1/arkctl: Get "https://proxy.golang.org/serverless.alipay.com/sofa-serverless/v1/arkctl/@v/list": dial tcp 142.251.42.241:443: i/o timeout
+```
+##### 解决方式
+arkctl 是作为 sofa-serverless 子目录的方式存在的，所以没法直接 go get，可以从这下面下载执行文件, 请参考[安装 arkctl](https://github.com/sofastack/sofa-serverless/releases/tag/arkctl-release-0.1.0)
+
+#### 问题 1-4：模块安装报 `Master biz environment is null`
+
+##### 解决方式，升级 sofa-serverless 版本到最新版本
+```xml
+<dependency>
+    <groupId>com.alipay.sofa.serverless</igroupId>
+    <artifactId>sofa-serverless-app-starter</artifactId>
+    <version>${最新版本号}</version>
+</dependency>
+```
+
+#### 问题 1-5：模块静态合并部署无法从制定的目录里找到模块包
+##### 解决方式：升级 sofa-serverless 版本到最新版本
+```xml
+<dependency>
+    <groupId>com.alipay.sofa.serverless</igroupId>
+    <artifactId>sofa-serverless-app-starter</artifactId>
+    <version>${最新版本号}</version>
+</dependency>
+```
+#### 问题 1-6：用户工程与 SOFAServerless 里 guice 版本不一致，且版本较老
+报错信息：
+```text
+Caused by: java.Lang.ClassNotFoundException: com.google.inject.multibindings.Multibinder
+```
+![guice_version_incompatibility.png](imgs/guice_version_incompatibility.png)
+
+##### 解决方式：升级 guice 版本到较新版本，如
+```xml
+<dependency>
+    <groupId>com.google.inject</groupId>
+    <artifactId>guice</artifactId>
+    <version>6.0.0</version>
+</dependency>
+```

docs/content/zh-cn/docs/tutorials/module-development/module-dev-arkctl.md

@@ -5,14 +5,16 @@ weight: 400
 
 ## Arkctl 工具安装
 
+Arkctl 模块安装主要提供自动打包和部署能力，自动打包调用 mvn 命令构建模块 jar包，自动部署调用 [arklet](/docs/contribution-guidelines/arklet/architecture/) 提供的 api 接口进行部署。如果不想使用命令行工具，也可以直接使用 arklet 提供的 api 接口发起部署操作。
+
 方法一：
 
 1. 本地安装 go 环境，go 依赖版本在 1.21 以上。
 2. 执行 go install `todo 独立的 arkctl go 仓库` 命令，安装 arkctl 工具。
 
 方法二：
 
-1. 在 [二进制列表]([https://github.com/sofastack/sofa-serverless/tree/master/arkctl/bin](https://github.com/sofastack/sofa-serverless/releases/tag/arkctl-release-0.1.0)) 中下载对应的二进制并加入到本地
+1. 在 [二进制列表](https://github.com/sofastack/sofa-serverless/releases/tag/arkctl-release-0.1.0) 中下载对应的二进制并加入到本地
    path 中。
 
 ### 本地快速部署