CodeIgniter项目出问题多因配置、环境或逻辑细节错误而非框架本身。高频雷区包括：数据库连接与查询失败（检查database.php配置、SQL执行结果）、URL路由与重写失效（base_url格式、.htaccess或Nginx配置、路由顺序）、表单复选框数据丢失（name带[]、post数据为数组、insert_batch格式）、CORS跨域异常（手动加响应头、处理OPTIONS预检、Cookie需配套设置）。
CodeIgniter项目出问题，多数不是框架本身坏了，而是配置、环境或逻辑细节没对上。排查时别一上来就怀疑框架，先盯住几个高频“雷区”——这些地方踩中一个，就可能让整个页面白屏、报错或数据不入库。
数据库连接与查询失败
这是最常卡住开发者的环节。错误提示可能是“Database Error: Unable to connect”，也可能是查询返回空结果但没报错。
- 确认
application/config/database.php中的hostname、username、password、database全部正确，尤其注意本地用localhost时，MySQL 8+ 默认用auth_socket插件，可能需改用127.0.0.1或重置用户认证方式 - SQLSRV 驱动下，
$query->result()返回空？别直接 echo，先用var_dump($query)看对象是否创建成功；再检查是否漏调用了result()或result_array()—— CI3 的查询对象不会自动转成数组 - 插入失败却没报错？在模型中加一句
echo $this->db->last_query(); die;，把实际执行的 SQL 拿出来贴到数据库客户端里手动跑一遍，常能发现字段类型不匹配、NULL 写入非空字段、外键约束冲突等问题
URL 路由与重写失效
点击链接跳转 404、base_url() 输出空白、site_url() 拼出错路径——基本都出在 URL 层。
-
$config['base_url']必须以http://或https://开头，且末尾带斜杠，例如http://localhost/myapp/；设成/myapp/会导致资源加载失败 - Apache 下确保
.htaccess文件存在且内容正确（CI 官方提供模板），同时开启mod_rewrite并重启 Apache；Nginx 用户则必须在 server 块中添加try_files $uri $uri/ /index.php?$query_string; - 路由规则写在
application/config/routes.php，注意顺序：越具体的规则越往前放，否则$route['(:any)'] = 'pages/view/$1';这类兜底规则会拦截所有请求
表单提交与复选框数据丢失
权限管理、多选标签等场景下，复选框提交后数据库没写入，控制台没报错，但提示 “Permission not updated”。问题往往不在 SQL，而在 PHP 数据接收逻辑。
- HTML 中复选框 name 必须带
[]，如<input type="checkbox" name="permissions[]" value="1">，否则$this->input->post('permissions')只能拿到最后一个被选中的值 - 控制器里别直接
$this->db->insert_batch()，先var_dump($this->input->post('permissions'))确认是数组；空数组或null会导致插入失败且静默忽略 - 模型中批量插入前，检查数组结构是否为二维关联数组（如
[ ['role_id'=>1, 'perm_id'=>5], [...] ]），CI 的insert_batch()对格式敏感，一维数组会报错
CORS 与跨域请求异常
前端用 Vue/React 调后端 API 时出现 No 'Access-Control-Allow-Origin' header，页面控制台报错但接口其实能正常执行（比如 POST 成功但浏览器拦住响应）。
- CI3 没内置 CORS 中间件，最稳妥做法是在 BaseController 构造函数里统一加头：
header('Access-Control-Allow-Origin: http://localhost:3000');，生产环境务必替换为具体域名，禁用*（尤其带 credentials 时） - 预检请求（OPTIONS）必须被正确响应。可在路由中单独配一条：
$route['api/(\w+)']['options'] = 'Api::cors';，并在对应控制器方法里只输出必要头信息并exit - 携带 Cookie 时，除了
Access-Control-Allow-Origin要写明确域名，还必须加Access-Control-Allow-Credentials: true，且前端 fetch 要设credentials: 'include'
