Gallery2疑难解答[ ]
Gallery2疑难解答的更多链接：Category:Gallery 2:Troubleshooting
需要预先做好的工作[ ]
- 清除Gallery缓存！-参见如何清除缓存数据？
- 确保Gallery应用程序文件完好无损！-常见问题：如何确保安装文件完整无损？
- 清除web浏览器缓存（cookies及页面缓存）！
- 启用'buffered'debug模式以确保没有遗漏任何重要警告或详细信息
重要提示： 如果你没有以管理员身份登录的话，你需要启用'buffered'debug模式来检查错误名称及详细信息。参见：常见问题：如何设置/使用Gallery的debug模式？。如果'buffered' debug模式没有任何显示的话，你可以尝试'immediate'或'logged' debug模式。
解决手段...[ ]
你可以查找相应特定的'错误名称'来确定遇到的问题，或者在经过分类的症状中对号入座。
错误名称（Error Name）[ ]
是不是在访问Gallery首页时就发生了错误？如果错误仅当浏览特定页面/相册时发生或尝试进行某特殊动作时发生的话，你应当先通过错误症状/尝试进行的动作的分类来尝试解决问题（见下表）。
| 错误名称 |
解决办法
|
| ERROR_PLATFORM_FAILURE
|
常见问题：如何修复Gallery存储文件夹文件系统权限问题？
|
| ERROR_OBSOLETE_DATA
|
常见问题：如何清除缓存数据？
|
| ERROR_REQUEST_FORGED
|
- 登出或清除浏览器cookies并重试。
- 如果你的Gallery被整合在了一个blog，门户或论坛等之中的话，请确保是使用的整合是最新版本的。
|
| ERROR_STORAGE_FAILURE
|
|
| ERROR_BAD_PARAMETER
|
是否自定义/编辑任何模板（.tpl）文件了？或者你是否在使用某第三方外观主题或模块？请尽量避免这种非官方代码所造成的破坏，你可以移除它们（拿外观主题/模块做个例子，只讲它们从modules/和themes/ 文件夹中移除是不够的）。
|
| ERROR_LOCK_TIMEOUT
|
参见常见问题：我突然得到了此错误消息"ERROR_LOCK_TIMEOUT"，我该怎么办？
|
| ERROR_MISSING_ITEM
|
- 如果你尚可访问'站点管理（Site Admin）'部分的话，你应当考虑运行第三方模块，'完整性（integrity）'模块的'完整性检查'。对于G2.2之后的版本来说，它可以在'站点管理（Site admin）' -> '插件（Plugins）'中找到。参见：额外组件的安装。
- 需要做的：为手动修复此类问题的相关指导添加链接。
|
错误症状（Symptom）/尝试性动作（Attempted Action）[ ]
请在下面的分类中定位你碰到的问题。请记住，debug模式启用后可以显示更多该问题的相关信息，这与不使用debug模式具有天壤之别。
安装[ ]
| 错误症状/尝试性动作 |
解决办法
|
| 无法通过验证（第二步）/login.txt
|
参见常见问题：为什么安装程序不接受我的login.txt？
|
| 系统检查（System Checks）报告了有关'文件完整性'的问题
|
参见常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？
|
| 存储的安装（Storage Setup）（第四步）-创建目录结构错误
|
- 此错误多发生于Windows/IIS服务器。参见Windows Server中的安装
- 如果发生在linux / unix服务器上并且通过FTP客户端确定g2data文件夹的权限为world-writeable（777）的话，请要求你的webhost来查明为何在g2data/中不允许PHP脚本进行文件夹结构的创建。
|
| 存储的安装（Storage Setup）（第四步）-页面空白/尝试提交时超时
|
如果你在使用G2.1.2的话，请尝试使用G2.2版本。你也该看看有关web服务器错误日志的相关信息。
|
| 失去对话（Losing Session）/回退到验证步骤
|
如果你在使用G2.1.2的话，请尝试使用G2.2版本（由于2.1版本中相关的cookieless问题）。你也应检查一下PHP的对话设定。你可以通过PHPInfo页面来查看PHP设定，这在此常见问题条目中有解释：常见问题：在论坛寻求帮助时哪些信息是必要的？
|
| 数据库安装（Database Setup）（第五步）-丢失的/错误的数据库连接信息
|
- 数据库连接信息对每个host来说都是不同的。请询问你的webhost以获取正确的数据库连接信息。
- 此信息一般在网站的管理面板中可以找到（非Gallery的一部分）。
- 许多webhosts在数据库名称和数据库用户名称前添加了一个前缀（如你的帐户名称）。
- 如果不了解'column prefix'和'table prefix'的话，请不要妄加修改。
|
| 数据库安装（Database Setup）（第五步）-客户端不支持验证协议
|
参见常见问题：为何使用MySQL 4.1或更高版本却不能进行安装？以及常见问题：MySQL错误："客户端不支持验证协议（Client does not support authentication protocol）"
|
| 数据库安装（Database Setup）（第五步）-其他的连接问题
|
|
| 数据库安装（Database Setup）（第五步）-非默认端口（Non-Default Port）
|
如果你需要使用一个非默认端口的话，请将:xxxx后置到主机名（Host Name）之后，如本地主机3307端口就是'localhost:3307'。
|
| 安装核心模块（Install Core Module）（第八步）失败
|
- 参见常见问题：我在安装的第八个步骤（核心模块的安装）时，遇到了错误。怎么回事？（对于Gallery 2.2以来的版本，我们在系统检查步骤中以对此问题作出了警告）
- 保证PHP memory_limit为16 MB或更高。8 MB往往不是很够。
- 刷新页面或重新进行该步骤是没用的。
- 有时重新运行安装程序可以解决问题。
- 要重试的话，你需要删除存储文件夹，清除数据库并从第四步（或前面的步骤）中重启安装程序，再重复这些步骤。注：为了能够节省些时间，你可以点击左侧的"数据库安装（Database Setup）"步骤的链接，点击"保存（save）"，再点击"清除（erase）"。这样你就不用手动删除存储文件夹和数据库了。
|
升级[ ]
图片[ ]
| 错误症状/尝试性动作 |
解决办法
|
| 无法正常生成缩略图或重设尺寸的图片
|
参见常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
|
| 不显示任何图片
|
|
| 当尝试进行缩略图或重设尺寸图片创建时发生错误
|
先将图片工具包卸载再重新进行安装。详细信息见于：常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
|
| 缩略图（不）呈方（矩）形而不按正常的长宽比显示
|
当'square thumbs'模块处于激活状态时，Gallery就会生成方（矩）形缩略图。Deactivate this module in 在'站点管理（Site Admin）' -> '插件（Plugins）'中禁用此模块（G2.2版本以前为'模块（Modules）'）可改变这种状况。若要修改已有的缩略图，你需要对它们进行重建。打开'编辑相册（Edit Album）' -> '相册（Album）'并按照新的设定重建缩略图。
|
| 尝试查看图片时发生错误
|
是何种错误？参见以下有关'按错误名称解决问题'部分。
|
| 图片的读取速度太慢
|
- Apache的mod_deflate/gzip没有对二进制文件禁用？
- 服务器CPU，文件I/O或是带宽限制？参见性能调校技巧
|
| 较大尺寸的图片变形/崩溃
|
- 此问题较罕见。尚无相关的详细信息。我们怀疑是web服务器配置问题或web服务器的bug所致。
- 使用FTP检查g2data/albums/下的文件是否正确。这能帮助你探明是服务器上的文件崩溃还是在向浏览器的传输过程中崩溃的。
|
视频/Flash[ ]
| 错误症状/尝试性动作 |
解决办法
|
| 显示的是下载链接而不是期望的电影播放器
|
- 是否在'编辑电影（Edit movie）' -> '电影（Movie）'中对视频尺寸进行了设定？Gallery仅显示设定过尺寸（值大于0）的嵌入电影播放器。你可以先在计算机上播放此电影来查看其尺寸（类似VLC或Windows媒体播放器的电影播放器来说，尺寸的相关信息可在电影属性中找到）。
- 注：如果ffmpeg模块处于激活状态的话，Gallery将会自动检查并为所有的电影设置尺寸（除非你的ffmpeg二进制无法处理某特定的电影格式）。
|
| 视频无缩略图
|
- ffmpeg模块是否启用了？仅当此模块启用时，Gallery才能够为电影生成缩略图。
- 你的ffmpeg二进制能否处理特定格式的电影？在'站点管理（Site Admin）' -> 'ffmpeg'中科点击'测试（Test）'来看看何种类型的视频可以被正确地处理。
|
| 无法定位ffmpeg二进制
|
请参考ffmpeg模块获取更详细的信息。
|
| 电影无法播放
|
参见常见问题：为什么电影无法在我的Gallery中播放了？
|
添加项目/相册/上传[ ]
| 错误症状/尝试性动作 |
解决办法
|
| 无法进行上传
|
- 要诊断此问题你应当使用'添加项目（Add items）' -> '自浏览器（From browser）'的方法，因为此方法能够提供最详实的debug信息。
- 若PHP上传在你的服务器上完全被禁用的话，在'添加项目（Add items）' -> '自浏览器（From browser）'页面上会有警告提示。此页面同样显示有上传限制。
- 当你尝试上传一个文件时看到了什么？错误吗？
- 确保PHP的upload_tmp_dir配置无误。如果查看你的web服务器日志的话，可能会看到'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'这样的错误。这种情况下，upload_tmp_dir不是没有被定义就是web服务器不具备该目录的文件写入权限。其他错误或警告可能是同样情况。
|
| 无法上传大文件
|
参见常见问题：为何我不能上传大文件（1MB或2MB的文件）？
|
| 点击上传按钮后出现这样的错误ERROR_STORAGE_FAILURE
|
参见常见问题：添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误，我该怎么办？
|
登录[ ]
参见常见问题：我怎么都无法登录了，怎么办？
| 错误症状/尝试性动作 |
解决办法
|
| 登录失败，发生错误或警告
|
- 忘记密码了？（Email找回密码的方式无效了？请联系管理员，管理员可以使用login.txt来修复Email或重置用户帐户）
- 密码中是否含有特殊字符？在Gallery2.1版之前，在某些情况下这将会导致登录时出现问题。请考虑升级你的Gallery。
- 是否显示你的用户帐户被"禁用"了？（G2.2版本以来）请使用登录页面上的"忘记密码（Forgot Password）"链接来重新激活你的帐户。
|
| 登录失败，然后再次显示的还是一个正常的Gallery页面
|
- 往往清除浏览器cookie缓存会有一定效果。检查你的web浏览器设定，清除Gallery站点的cookies。
- 有时你会在登录后看到的还是登录页面，因此就认为没有登录成功，但是实际上你已经登录了；但是由于你的浏览器没有更新其缓存，所以会出现这种情况。请检查你web浏览器的设定并清除浏览器缓存。
- 你的web服务器IIS/5.0版本过旧还是你的Gallery2的版本低于2.0？在Gallery2.0发布前不久我们就为某IIS bug添加了一个变通的修复手段，你应当升级你的Gallery。
|
工具包/模块的激活[ ]
| 错误症状/尝试性动作 |
解决办法
|
| 在尝试测试二进制（或保存配置）时发生了错误
|
- 参见：图片处理库的安装
- 错误报告是否为指定路径下找不到文件？参见以上链接文章中有关'路径'的注释。
|
| 在测试二进制时，netpbm报告'errno 13 (permission denied)'的错误或' Error reading magic number'的错误
|
如果你确定文件系统权限设置无误的话，请查看一下在SELinux服务器上安装的相关信息。
|
| Windows/IIS：我无法安装任何二进制
|
参见在MS Windows/IIS服务器上进行二进制的安装。
|
| Windows: 有关'unable to fork'的警告
|
参见[[Gallery:FAQ#我在Windows/IIS下G2安装程序的模块步骤得到了许多"Warning: exec(): Unable to fork [cmd /c ...]"（ImageMagick模块）这样的警告提示，该怎么办？|常见问题：我在Windows/IIS下G2安装程序的模块步骤得到了许多"Warning: exec(): Unable to fork [cmd /c ...]"（ImageMagick模块）这样的警告提示，该怎么办？]]
|
外观主题[ ]
| 错误症状/尝试性动作 |
解决办法
|
| 无法将外观主题上传至themes/文件夹
|
参见常见问题：当使用预安装程序后，如何通过FTP软件上传一个外观主题或模块？
|
| 无法编辑外观主题的设定
|
- 是否仅可编辑'matrix'外观主题而不能编辑某第三方外观主题？如果是这样的话，那么这就很可能是第三方外观主题特有问题了，因此你最好直接联系此第三方外观主题的编写者。
- 你的浏览器是否允许Java脚本语言？
- 外观主题区块是否毫无显示？有可能你的web浏览器没有正确配置因此拦截了JavaScript的请求。或者为JavaScript所返回的内容类型不正确。请浏览http://www.example.com/gallery/lib/javascript/BlockSelectWidget.js（修改其中的URL地址为你Gallery的位置），如果文件的JavaScript代码在你的web浏览器中显示正确（或可以保证你计算机上文件安全）的话，那么就没问题了。相反，则有可能是'mod_security'的问题了。参见：已知问题 -> Apache mod_security。你的webhost应当被告知此问题，这样他们才能对web服务器的配置进行修复。
|
| 在修改外观主题后，所有东西都无法运行了
|
参见常见问题：我修改了默认外观主题但什么都运行不了了。怎样才能还原？
|
| 无法访问'站点管理（Site admin）'
|
参见常见问题：在无法访问站点管理的情况下如何改变默认的外观主题？
|
模块[ ]
翻译/本地化[ ]
其他[ ]
